如何在Shell环境下简化C#单元测试执行流程？

其他编程语言的单元测试执行流程十分简洁：Java用mvn test，Node.js用npm run test，Python用python -m unittest，这些工具支持通过配置文件或代码设置复杂参数，还能一键生成HTML报告，完美适配DevOps自动化需求。但在C#中，目前实现类似流程需要多步命令，还需额外安装工具，以下是几种简化方案：

1. 用Shell脚本封装全流程 #

将测试执行、覆盖率收集、报告生成的所有步骤封装到一个Shell脚本中（比如命名为test-with-coverage.sh），还可直接集成覆盖率阈值、徽章生成等配置：

#!/bin/bash

# 定义全局参数
COVERAGE_DIR="./.coverage"
EXCLUDE_FILES="$(pwd)/src/Common/**/*,$(pwd)/src/Startup.cs,$(pwd)/src/Program.cs"
COVERAGE_THRESHOLD=80 # 行覆盖率阈值

# 创建覆盖率输出目录
mkdir -p $COVERAGE_DIR

# 执行测试并收集覆盖率（含阈值校验）
dotnet test /p:CollectCoverage=true /p:CoverletOutputFormat=opencover /p:ExcludeByFile="$EXCLUDE_FILES" /p:CoverletOutput=$COVERAGE_DIR/ /p:Threshold=$COVERAGE_THRESHOLD /p:ThresholdType=line

# 生成HTML报告和覆盖率徽章
reportgenerator "-reports:$COVERAGE_DIR/coverage.opencover.xml" "-targetdir:$COVERAGE_DIR" -reporttypes:Html;Badges

echo "测试完成，覆盖率报告和徽章已生成在 $COVERAGE_DIR 目录"

给脚本添加执行权限后，只需运行./test-with-coverage.sh即可完成所有操作：

chmod +x test-with-coverage.sh
./test-with-coverage.sh

2. 把配置嵌入测试项目文件 #

将覆盖率相关参数直接写入测试项目的.csproj文件，减少命令行参数复杂度：

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net6.0</TargetFramework>
    <IsPackable>false</IsPackable>
    <!-- 覆盖率核心配置 -->
    <CollectCoverage>true</CollectCoverage>
    <CoverletOutputFormat>opencover</CoverletOutputFormat>
    <ExcludeByFile>$(SolutionDir)src/Common/**/*;$(SolutionDir)src/Startup.cs;$(SolutionDir)src/Program.cs</ExcludeByFile>
    <CoverletOutput>$(SolutionDir).coverage/</CoverletOutput>
    <Threshold>80</Threshold>
    <ThresholdType>line</ThresholdType>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="coverlet.collector" Version="3.2.0" PrivateAssets="all" />
    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.7.2" />
    <PackageReference Include="xunit" Version="2.4.2" />
    <PackageReference Include="xunit.runner.visualstudio" Version="2.4.5" />
  </ItemGroup>
</Project>

之后命令可简化为：

# 执行测试（自动收集覆盖率）
dotnet test
# 生成报告和徽章
reportgenerator "-reports:.coverage/coverage.opencover.xml" "-targetdir:.coverage" -reporttypes:Html;Badges

再将这两行命令封装到Shell脚本中，即可实现一键执行。

3. 本地安装工具替代全局安装 #

避免全局安装reportgenerator的权限冲突问题，可将工具安装到项目本地：

# 初始化本地工具清单
dotnet new tool-manifest
# 安装reportgenerator到项目本地
dotnet tool install dotnet-reportgenerator-globaltool

团队成员克隆项目后，只需执行dotnet tool restore即可同步工具，执行报告生成命令时改为：

dotnet tool run reportgenerator "-reports:.coverage/coverage.opencover.xml" "-targetdir:.coverage" -reporttypes:Html;Badges

关于.runsettings配置失败的修正 #

若之前尝试.runsettings未成功，大概率是路径配置错误或未在命令中指定配置文件。以下是正确的配置示例（命名为coverage.runsettings）：

<?xml version="1.0" encoding="utf-8"?>
<RunSettings>
  <DataCollectionRunSettings>
    <DataCollectors>
      <DataCollector friendlyName="XPlat Code Coverage">
        <Configuration>
          <Format>opencover</Format>
          <ExcludeByFile>**/src/Common/**/*,**/src/Startup.cs,**/src/Program.cs</ExcludeByFile>
          <Output>.coverage/</Output>
          <Threshold>80</Threshold>
          <ThresholdType>line</ThresholdType>
        </Configuration>
      </DataCollector>
    </DataCollectors>
  </DataCollectionRunSettings>
</RunSettings>

执行测试时需显式指定配置文件：

dotnet test --settings:coverage.runsettings

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