Visual Studio 2022 (17.6 Preview 2) 带来了拼写检查功能，此功能一出大家纷纷吐槽各种问题。不过团队中确实时不时会出现单词拼写错误的情况，所以有时又觉得非常需要它。
如果你打算在 Visual Studio 中好好使用这个自带的功能，那么可以阅读本文。对它有更多的了解之后，也许可以逐渐趋利避害。
开启拼写检查功能
目前，拼写检查器功能仍然是预览功能，所以需要在 Visual Studio 的“工具”->“选项”菜单中找到“环境”->“预览功能”选项卡，然后找到“拼写检查器”功能，把它打开。
拼写检查和忽略单词
开启了 Visual Studio 拼写检查器功能后，如果再在代码中写出了错误的单词，则会视时给出下划线提醒。不过注意，这个提醒只是 IDE 的提醒，不会出现在项目编译过程的警告或信息中。
下图是对 embedding 单词的错误拼写进行了纠正。
Visual Studio 的拼写检查器是基于字典的，这意味着必然存在一些专有/私有词汇会被误认为不正确。例如，我的名字“walterlv”。
这时，我们应该忽略这个拼写。在单词旁边的小灯泡上点击（使用重构快捷键可打开），然后选择“拼写：忽略”walterlv””即可忽略这个单词的拼写。
调教拼写检查器
全局忽略文件
Visual Studio 拼写检查器忽略功能的优点是，这个忽略是全局生效的，对所有已经打开的项目和未来打开的项目都生效；而缺点也同样是这个。（我其实比较期待有个全局忽略列表的前提下，可以在项目内增加一个项目特定的忽略列表。）
这个全局的忽略列表存在这个地方：
1
%LocalAppData%\Microsoft\VisualStudio\17.0_14b1edd8\exclusion.dic
如果你打开这个文件会发现很奇怪，每个单词的前面都有一个不可识别的字符。在 Visual Studio 和 Visual Studio Code 中打开这个文件可以发现这一点。
具体这个字符是什么，我们可以使用十六进制查看工具查看：
可以注意到这个文件的：
- 每个单词前都有一段
EF BB BF，而这个是 UTF-8 的 BOM 头 - 每个单词后都有一个
0D 0A，而这个是 Windows 的换行符，对应\r\n - 文件的开头有两个 UTF-8 BOM 头
这几乎可以肯定是 Visual Studio 拼写检查器的 bug！！！在这个功能刚发布的时候，忽略单词并不会生效，可能与这个 bug 有关，不过好在后面即使有不符合预期的 BOM 头出现，也不会导致忽略单词不生效。
如果你是一个强迫症，那么可以把这个词典文件删除，新的 Visual Studio 生成的忽略文件已经不会再有 UTF-8 BOM 头了（包括文件开头的 BOM 头）。如果这个文件一直保留，那么新的 Visual Studio 写新的忽略单词也会包含这个 BOM 头。如果你不想删除，那么可以使用 Visual Studio Code 编辑手动去掉这些 BOM 头之后，保存为无 BOM 的 UTF-8 文件即可。
参考资料
- Improving the Spell Checker - Visual Studio Blog
- Learn about the Spell Checker - Visual Studio (Windows) - Microsoft Learn
本文会经常更新，请阅读原文： https://blog.walterlv.com/post/visual-studio-spell-checker-issue ，以避免陈旧错误知识的误导，同时有更好的阅读体验。
本作品采用 知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议 进行许可。欢迎转载、使用、重新发布，但务必保留文章署名 吕毅 （包含链接： https://blog.walterlv.com ），不得用于商业目的，基于本文修改后的作品务必以相同的许可发布。如有任何疑问，请 与我联系 ([email protected]) 。