如何阻止Visual Studio特定构建配置下单元测试触发时项目构建

问题背景 #

我有一个项目，使用DevDeploy构建配置时会自动部署到开发服务器。需要实现：

• 运行MS Test单元测试时，该项目不被构建，避免触发部署
• 直接构建项目（非测试场景）时，正常完成构建和部署

尝试过通过.runsettings设置TestRun=true环境变量，并在项目文件中添加Target判断，但$(TestRun)始终为空，无法生效。

原因分析 #

.runsettings中定义的环境变量不会自动传递给MSBuild的构建流程——VS触发测试时的构建，不会把测试运行的环境变量映射为MSBuild属性，因此项目文件中无法读取到$(TestRun)。

可行解决方案 #

方案1：通过MSBuild属性传递测试标识（推荐） #

直接在测试运行时给MSBuild传递属性，替代环境变量的方式：

子方案A：修改测试项目的依赖关系

如果测试项目依赖部署项目，在测试项目的.csproj中添加条件，仅非测试运行时引用该项目：

<ItemGroup>
  <!-- 仅当TestRun不为true时，引用部署项目 -->
  <ProjectReference Include="..\YourDeployProject\YourDeployProject.csproj" 
                    Condition="'$(TestRun)' != 'true'" />
</ItemGroup>

然后运行测试时传递属性参数：

• 命令行运行：

vstest.console.exe YourTestProject.dll /p:TestRun=true

• VS中设置：在测试菜单→测试设置→选择对应的.runsettings，然后通过工具→选项→项目和解决方案→生成并运行，添加MSBuild参数/p:TestRun=true

子方案B：在部署项目中直接检测MSBuild属性

修改部署项目的.csproj，直接判断MSBuild属性$(TestRun)，满足条件时跳过构建：

<Target Name="SkipBuildOnTestRun" BeforeTargets="Build">
  <PropertyGroup>
    <SkipBuild Condition=" '$(Configuration)' == 'DevDeploy' and '$(TestRun)' == 'true' ">true</SkipBuild>
  </PropertyGroup>
  <Message Text="Skipping build during test run (DevDeploy configuration)." Condition="'$(SkipBuild)' == 'true'" Importance="High" />
  <StopBuild Condition="'$(SkipBuild)' == 'true'" />
</Target>

运行测试时同样传递/p:TestRun=true参数，MSBuild就能直接识别该属性，跳过部署项目的构建。

方案2：VS手动测试时禁用预构建 #

如果仅在VS中手动运行测试，可以直接：

1. 右键测试项目 → 属性
2. 切换到「测试」标签页
3. 勾选「运行测试之前不要构建」
   这种方法操作简单，但仅适合手动场景，无法用于自动化测试。

方案3：直接读取系统环境变量 #

如果坚持使用环境变量，修改项目文件，直接读取系统环境变量而非依赖.runsettings：

<Target Name="FailOnTestRun" BeforeTargets="Build">
  <PropertyGroup>
    <IsTestRun Condition=" '$(Configuration)' == 'DevDeploy' and '$(BuildingInsideVisualStudio)' == 'true' and $([System.Environment]::GetEnvironmentVariable('TestRun')) == 'true' ">true</IsTestRun>
  </PropertyGroup>
  <Error Condition="'$(IsTestRun)' == 'true'" Text="Building this project is not allowed during test runs." />
</Target>

运行测试前先设置系统环境变量：

# Windows命令行
set TestRun=true

# PowerShell
$env:TestRun = "true"

再执行测试命令即可。但这种方法需要提前设置环境变量，灵活性较差。

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