如何在GitHub Actions Windows运行器中构建测试.NET 4.5.x项目

针对.NET Framework 4.5.x这类传统框架项目，GitHub Actions上更适合用MSBuild而非dotnet CLI来处理，以下是具体解决步骤：

核心思路 #

放弃依赖setup-dotnet动作，直接利用Windows运行器预装的MSBuild和.NET Framework 4.8的向后兼容性来构建低版本项目，同时改用传统NuGet命令处理包依赖，避免CLI的兼容性问题。

具体步骤 #

• 选择合适的运行器：使用windows-2019而非windows-latest，该运行器预装了完整的.NET Framework开发工具链，包括对net45的目标框架支持，无需额外安装基础依赖。
• 更新NuGet客户端：先执行nuget update -self确保NuGet版本足够新，能正确处理老版本框架的包依赖。
• 恢复NuGet包：用nuget restore YourSolution.sln替代dotnet restore，传统NuGet命令对.NET Framework项目的包恢复兼容性更好，可避免部分包引用错误。
• 用MSBuild构建项目：直接调用MSBuild并指定目标框架，示例命令：

  msbuild YourSolution.sln /p:TargetFramework=net45 /p:Configuration=Release /p:Platform="Any CPU" /m
  

  参数说明：
  • /m：启用多线程构建，提升速度
  • 若遇到版本兼容警告，可添加/p:UseLatestRuntimePatch=false强制使用指定框架的运行时补丁
• 运行测试：使用Windows运行器预装的vstest.console.exe执行测试，示例命令：

  vstest.console.exe YourTestProject/bin/Release/net45/YourTestProject.dll /Logger:"console;verbosity=normal"
  

完整GitHub Actions工作流示例 #

name: .NET 4.5 CI/CD

on:
  push:
    branches: [ main ]
  pull_request:
    branches: [ main ]

jobs:
  build-and-test:
    runs-on: windows-2019
    steps:
    - uses: actions/checkout@v4

    - name: Update NuGet client
      run: nuget update -self

    - name: Restore NuGet packages
      run: nuget restore YourSolution.sln

    - name: Build solution
      run: msbuild YourSolution.sln /p:TargetFramework=net45 /p:Configuration=Release /p:Platform="Any CPU" /m

    - name: Run unit tests
      run: vstest.console.exe YourTestProject/bin/Release/net45/YourTestProject.dll /Logger:"console;verbosity=normal"

常见问题排查 #

• 目标框架找不到：若运行器缺少.NET 4.5开发包，可添加步骤安装：

  choco install dotnetfx-4.5-devpack -y
  

• NuGet包引用错误：检查包版本是否支持net45，降级到兼容版本；或在项目文件中给PackageReference添加AllowedVersions限制，确保安装兼容的包版本。

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