GitHub Actions缓存.NET安装后无法识别.NET 7的问题求助

核心问题是：缓存恢复.NET 7安装目录后，系统PATH未包含自定义的DOTNET_ROOT路径，导致dotnet命令依然调用windows-2019镜像自带的.NET 6。

actions/setup-dotnet在首次安装时会自动将DOTNET_ROOT添加到PATH，但当缓存命中跳过安装步骤时，这个PATH配置不会自动执行，所以系统还是优先使用全局的.NET 6。

方案1：缓存恢复后手动更新PATH #

在缓存步骤之后，添加一步手动将DOTNET_ROOT加入系统PATH，无论缓存是否命中都执行：

steps:      
  - name: Cache dotnet
    id: cache-dotnet-core
    uses: actions/cache@v3
    with:
      path: '.\.dotnet'
      key: ${{ runner.os }}-dotnet-7
      restore-keys: ${{ runner.os }}-dotnet-7

  # 新增：手动将自定义dotnet路径加入PATH
  - name: Add dotnet to PATH
    run: |
      echo "$env:DOTNET_ROOT" | Out-File -FilePath $env:GITHUB_PATH -Encoding utf8
    shell: pwsh

  - name: Install Dotnet
    if: steps.cache-dotnet-core.outputs.cache-hit != 'true' 
    uses: actions/setup-dotnet@v3
    with:
      dotnet-version: 7.0.x
      
  - name: validate dotnet version
    run: 'dotnet --version'

方案2：让actions/setup-dotnet自动处理缓存（更推荐） #

actions/setup-dotnet本身已经内置了缓存逻辑，无需手动使用actions/cache。只需启用cache: true参数，它会自动处理安装包的缓存和PATH配置：

name: dotnet-pipeline
on: [push]

jobs:
  build:
    name: check-dotnet-version
    runs-on: windows-2019

    steps:      
      - name: Install Dotnet
        uses: actions/setup-dotnet@v3
        with:
          dotnet-version: 7.0.x
          cache: true  # 启用内置缓存
          
      - name: validate dotnet version
        run: 'dotnet --version'

这个方案更简洁，且能避免PATH配置的问题，因为每次都会确保DOTNET_ROOT被正确加入PATH。

额外验证步骤（可选） #

如果想确认PATH和安装情况，可以在版本验证前添加调试步骤：

- name: Debug dotnet environment
  run: |
    echo "PATH: $env:PATH"
    echo "DOTNET_ROOT: $env:DOTNET_ROOT"
    dir $env:DOTNET_ROOT
  shell: pwsh

这样能直观看到PATH里是否包含自定义的.dotnet目录，以及缓存的文件是否正确。

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