为何VSTS中CA1704拼写错误更多？如何解决该问题？

我之前也碰到过类似的环境不一致问题，下面是几个可以排查和解决的方向：

1. 确认自定义拼写字典已纳入源代码控制 #

CA1704的拼写检查依赖字典文件，如果你在本地添加了CustomDictionary.xml来忽略特定业务术语的拼写，一定要确保这个文件已经提交到代码仓库，并且在项目中正确引用：

• 打开项目文件（.csproj/.vbproj），检查是否有如下配置：

  <ItemGroup>
    <CodeAnalysisDictionary Include="CustomDictionary.xml" />
  </ItemGroup>
  

• 如果没有，手动添加这段配置，再把字典文件提交到仓库，这样代理构建时就能加载和本地一致的拼写规则。

2. 统一代码分析规则集 #

本地VS可能使用了自定义规则集，而Hosted代理默认用的是标准规则集，导致检查严格度不一致：

• 在本地VS中右键项目→属性→代码分析，导出当前使用的规则集为.ruleset文件，将其添加到项目目录。
• 修改项目文件，指定使用这个自定义规则集：

  <PropertyGroup>
    <CodeAnalysisRuleSet>YourCustomRuleset.ruleset</CodeAnalysisRuleSet>
  </PropertyGroup>
  

• 提交规则集文件到仓库，确保代理构建时和本地用完全相同的检查规则。

3. 对齐代理与本地的代码分析工具版本 #

Hosted2017代理上的VS2017可能安装了不同的更新版本，或者代码分析组件版本和本地有差异：

• 在代理的构建日志里搜索MSBuild版本信息，或者添加一个命令行任务执行msbuild /version，对比本地VS2017的MSBuild版本。
• 如果版本差异较大，可以尝试在代理上安装对应的VS更新包，或者调整本地环境对齐代理版本（更推荐后者，毕竟构建环境要统一）。

4. 使用NuGet形式的代码分析器消除环境依赖 #

如果上面的方法都无效，建议改用NuGet包来管理代码分析工具，摆脱对代理VS安装的依赖：

• 给项目安装Microsoft.CodeAnalysis.FxCopAnalyzers NuGet包，这个包包含了统一版本的代码分析规则。
• 禁用项目中的传统FxCop分析（在项目属性的代码分析选项中关闭），让构建完全使用NuGet包中的分析器，这样本地和代理的检查逻辑就完全一致了。

5. 验证代理构建时的字典加载情况 #

有时候代理构建可能没正确加载字典，你可以在构建日志里搜索CodeAnalysisDictionary或CustomDictionary，确认文件是否被正确识别。如果日志里没有相关记录，检查项目中字典的相对路径是否正确，确保文件确实存在于仓库中。

内容的提问来源于stack exchange，提问作者Phil