如何在.NET Framework 4.8中用命令行运行单元测试并集成GitLab CI/CD

不同于.NET Core/.NET 5+的dotnet test命令，.NET Framework的单元测试需要借助Visual Studio配套的测试工具来在命令行运行，以下是具体实现方案：

环境准备 #

你的GitLab Runner（无论自托管还是使用微软托管的Windows Runner）必须安装Visual Studio Build Tools（推荐2022版本），安装时需勾选：

• .NET Framework 4.8目标包
• 测试工具核心功能（包含vstest.console.exe）

方案1：直接使用vstest.console.exe运行测试 #

这是最直接的方式，vstest.console.exe是Visual Studio官方的命令行测试运行器，支持.NET Framework单元测试。

命令示例 #

# 替换为你的测试项目编译后的DLL路径
"C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\Common7\IDE\CommonExtensions\Microsoft\TestWindow\vstest.console.exe" YourTestProject\bin\Release\YourTestProject.dll /Logger:trx

• /Logger:trx参数会生成标准的TRX测试报告，GitLab CI可以解析该格式展示测试结果
• 路径需根据你安装的VS/Build Tools版本调整（比如2019版本路径中的2022改为2019）

方案2：通过MSBuild触发测试 #

如果你的测试项目已经在Visual Studio中配置好测试关联，可以直接用MSBuild的Test目标来运行测试，无需单独调用vstest.console.exe。

命令示例 #

msbuild YourTestProject.csproj /t:Test /p:Configuration=Release /p:Platform="Any CPU"

• /t:Test指定执行测试目标
• /p:Configuration=Release确保使用编译后的Release版本测试集

GitLab CI/CD配置示例（.gitlab-ci.yml） #

将测试步骤加入CI流程，示例配置如下：

stages:
  - build
  - test

# 编译阶段：先编译解决方案
build:
  stage: build
  tags:
    - windows  # 确保使用Windows环境的Runner
  script:
    - msbuild YourSolution.sln /p:Configuration=Release /p:Platform="Any CPU"

# 测试阶段：依赖编译完成的测试集
test:
  stage: test
  tags:
    - windows
  needs: [build]
  script:
    - '"C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\Common7\IDE\CommonExtensions\Microsoft\TestWindow\vstest.console.exe" YourTestProject\bin\Release\YourTestProject.dll /Logger:trx'
  artifacts:
    reports:
      junit: '**/*.trx'  # 让GitLab解析TRX报告并展示测试结果

注意事项 #

• 如果使用自托管Runner，可将vstest.console.exe的路径加入系统环境变量，避免每次写完整路径
• 确保测试项目的输出目录与编译阶段的配置一致（比如都用Release）
• 若测试需要依赖其他项目的输出文件，需确保编译阶段的产物被正确传递到测试阶段（可通过artifacts临时存储）

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