如何创建仅用于C#单元测试的自定义任务？

一、修正MSBuild命令参数错误 #

你遇到的MSB1001错误是参数使用不当导致的：dotnet msbuild不支持--project参数，指定目标项目的正确方式是直接将项目路径作为命令参数。

指定测试项目的正确命令示例：

dotnet msbuild ./test/Test.csproj -target:Foo
# 或用缩写-t代替-target
dotnet msbuild ./test/Test.csproj -t:Foo

二、将自定义任务归属到测试项目 #

把MSBuild目标（Target）直接添加到./test/Test.csproj文件中，而非主项目，确保任务仅属于测试流程，不污染主项目配置。

以下是包含测试+代码覆盖率统计的完整示例配置：

<Project Sdk="Microsoft.NET.Sdk">
  <!-- 保留测试项目原有配置 -->
  <PropertyGroup>
    <TargetFramework>net6.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
    <IsPackable>false</IsPackable>
  </PropertyGroup>

  <!-- 自定义任务：执行测试并生成覆盖率报告 -->
  <Target Name="RunTestsWithCoverage" DependsOnTargets="Build">
    <!-- 执行单元测试并收集覆盖率数据 -->
    <Exec Command="dotnet test --no-build --collect:&quot;XPlat Code Coverage&quot;" />
    <!-- 生成HTML覆盖率报告（需提前安装全局工具：dotnet tool install -g dotnet-reportgenerator-globaltool） -->
    <Exec Command="reportgenerator -reports:./TestResults/**/coverage.cobertura.xml -targetdir:./CoverageReport -reporttypes:Html" />
  </Target>
</Project>

三、一键执行自定义任务 #

运行以下命令即可完成测试+覆盖率统计全流程：

dotnet msbuild ./test/Test.csproj -t:RunTestsWithCoverage

补充：简化命令的小技巧 #

若嫌每次输入项目路径麻烦，可在解决方案根目录创建跨平台脚本，比如Makefile：

# Makefile
test-coverage:
	dotnet msbuild ./test/Test.csproj -t:RunTestsWithCoverage

之后只需运行make test-coverage（Linux/macOS）即可一键执行。

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