GitHub Actions中dotnet restore误将SDK项目按.NET Framework处理的问题

问题根源 #

这个错误是因为dotnet restore在GitHub Actions的setup-dotnet环境中，误将SDK风格项目识别为旧式.NET Framework项目（非SDK格式）。尽管dotnet版本和二进制文件与本地一致，但环境中的MSBuild默认属性或项目识别逻辑存在差异，导致无法找到SDK项目的Restore目标。

直接解决办法 #

1. 精准指定SDK项目路径执行还原 #

不要在解决方案根目录直接跑dotnet restore，而是明确指定要处理的SDK风格项目文件，避免工具遍历到Framework项目时干扰识别：

- name: 还原SDK风格项目
  run: |
    dotnet restore ./src/MySdkProject1/MySdkProject1.csproj
    dotnet restore ./src/MySdkProject2/MySdkProject2.csproj

如果项目较多，可用通配符过滤（根据实际项目命名或路径调整）：

- name: 批量还原SDK项目
  run: dotnet restore **/*Sdk.csproj

2. 强制指定MSBuild SDK路径 #

在dotnet restore命令中通过-p:MSBuildSDKsPath参数明确SDK路径，确保工具正确识别SDK项目：

- name: 指定SDK路径还原项目
  run: dotnet restore -p:MSBuildSDKsPath="C:\Users\runneradmin\AppData\Local\Microsoft\dotnet\sdk\${{ env.DOTNET_VERSION }}\Sdks"
  env:
    DOTNET_VERSION: 6.0.x  # 替换为你实际使用的.NET SDK版本

可先执行dotnet --list-sdks确认GitHub Actions runner上的SDK安装路径，再调整参数值。

3. 拆分解决方案文件 #

创建仅包含SDK风格项目的专属解决方案（比如SdkProjects.sln），单独执行还原，彻底隔离Framework项目的影响：

steps:
  - name: 拉取代码
    uses: actions/checkout@v4

  - name: 配置.NET环境
    uses: actions/setup-dotnet@v4
    with:
      dotnet-version: |
        6.0.x
        4.8.x

  - name: 还原.NET Framework项目
    run: nuget restore ./src/FrameworkProjects.sln

  - name: 还原.NET SDK项目
    run: dotnet restore ./src/SdkProjects.sln

更优的GitHub Actions包还原方案 #

1. 启用缓存加速 #

用actions/cache缓存NuGet包和项目资产文件，减少重复下载时间：

- name: 缓存NuGet包
  uses: actions/cache@v3
  with:
    path: |
      ~/.nuget/packages
      **/obj/project.assets.json
    key: ${{ runner.os }}-nuget-${{ hashFiles('**/packages.lock.json', '**/*.csproj') }}
    restore-keys: |
      ${{ runner.os }}-nuget-

建议给SDK项目启用packages.lock.json锁定文件，提升缓存命中率。

2. 自动识别项目类型批量还原 #

用PowerShell脚本自动扫描项目文件，区分类型后执行对应还原命令，适合项目较多的场景：

- name: 批量还原所有项目
  run: |
    # 处理.NET Framework项目（不含<Sdk>属性的旧式csproj）
    Get-ChildItem -Recurse -Filter *.csproj | Where-Object { !$_.Content.Contains('<Sdk') } | ForEach-Object {
      nuget restore $_.FullName
    }
    # 处理.NET SDK项目
    Get-ChildItem -Recurse -Filter *.csproj | Where-Object { $_.Content.Contains('<Sdk') } | ForEach-Object {
      dotnet restore $_.FullName
    }
  shell: pwsh

3. 用MSBuild统一处理 #

直接使用MSBuild命令，自动识别项目类型并执行对应还原逻辑，无需拆分步骤：

- name: 统一还原所有项目
  run: msbuild ./FullSolution.sln /t:Restore /p:RestorePackagesConfig=true /p:RestoreProjectStyle=PackageReference

这个命令会对Framework项目（packages.config）执行传统还原，对SDK项目执行PackageReference还原，兼容性更好。

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