Visual Studio 2017项目EnsureNuGetPackageBuildImports致TeamCity构建失败

一、问题原因 #

1. NuGet还原与构建时机不匹配：本地Visual Studio构建时，NuGet还原和项目构建属于同一流程，会自动确保.props/.targets文件存在且满足导入条件；但TeamCity中NuGet Installer步骤和后续Visual Studio构建步骤是分离的，可能出现还原后的文件路径、条件上下文和构建预期不一致，触发EnsureNuGetPackageBuildImports的检查失败。
2. 带条件导入项的上下文差异：新增的Selenium相关NuGet包添加的导入项带有配置/平台条件（如Condition=" '$(Configuration)|$(Platform)' == 'Debug|AnyCPU' "），TeamCity构建时使用的配置、平台参数和本地VS测试时不一致，导致条件不满足、导入未生效，但EnsureNuGetPackageBuildImports仍会强制检查文件存在，引发冲突。
3. NuGet还原不完整：NuGet Installer步骤可能未正确处理Selenium包的嵌套依赖，导致部分.props/.targets文件未下载到TeamCity构建代理的本地目录。

二、修复/规避方案 #

• 合并NuGet还原与构建步骤：删除TeamCity中的NuGet Installer步骤，在Visual Studio构建步骤中勾选「Restore NuGet packages」选项。让VS构建流程自行处理包还原和导入检查，确保两者上下文完全一致，避免分离步骤带来的不匹配问题。
• 针对性跳过TeamCity环境的检查：修改项目.csproj文件，给EnsureNuGetPackageBuildImports目标添加环境条件，仅在非TeamCity环境执行：

  <Target Name="EnsureNuGetPackageBuildImports" BeforeTargets="PrepareForBuild" Condition="'$(TeamCity_BuildId)' == ''">
    <!-- 保留原有的检查内容 -->
  </Target>
  

  TeamCity会自动注入TeamCity_BuildId环境变量，该目标在构建代理上会被跳过，同时不影响本地VS的正常检查。
• 对齐构建参数与本地环境：检查TeamCity构建配置中的「Configuration」「Platform」参数，确保和本地VS测试时完全一致（比如都是Release|AnyCPU），让带条件的导入项正常生效，避免检查失败。
• 统一NuGet版本：在TeamCity的NuGet Installer步骤中，选择和本地Visual Studio使用的相同NuGet版本（可在VS的「Tools → NuGet Package Manager → Package Manager Settings」中查看），消除版本差异导致的还原逻辑不一致问题。

三、TeamCity对这类检查的支持情况 #

TeamCity本身没有内置替代EnsureNuGetPackageBuildImports的检查功能，但可以通过自定义脚本实现类似逻辑：比如在构建前添加PowerShell步骤，遍历项目文件中的<Import>节点，校验对应的.props/.targets文件是否存在。不过更推荐使用前面的方案，利用VS和NuGet的原生协同流程解决问题，无需额外自定义检查。

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