You need to enable JavaScript to run this app.
最新活动
大模型
产品
解决方案
定价
生态与合作
支持与服务
开发者
了解我们

如何在GitHub托管运行器中安装Visual Studio 2026 Build Tools并用于CI构建?

在GitHub Actions中安装Visual Studio 2026 Build Tools(MSBuild 18)并完成CI构建

由于GitHub托管的Windows运行器暂未预装Visual Studio 2026 Build Tools(MSBuild 18),你可以通过以下步骤手动安装并完成CI构建:

方法一:使用官方安装引导程序(推荐)

通过微软官方提供的vs_buildtools.exe引导程序,自定义安装所需的构建工具和工作负载:

GitHub Actions配置示例

name: Build with VS2026 Build Tools
on: [push, pull_request]

jobs:
  build:
    runs-on: windows-latest
    steps:
      - name: 拉取代码
        uses: actions/checkout@v4

      - name: 下载VS2026 Build Tools安装引导程序
        run: |
          Invoke-WebRequest -Uri "https://aka.ms/vs/18/release/vs_buildtools.exe" -OutFile vs_buildtools.exe
        shell: pwsh

      - name: 安装VS2026 Build Tools及所需工作负载
        run: |
          .\vs_buildtools.exe --quiet --wait --norestart --nocache `
            --installPath "C:\Program Files\Microsoft Visual Studio\2026\BuildTools" `
            --add Microsoft.VisualStudio.Workload.MSBuildTools `
            --add Microsoft.VisualStudio.Workload.NetCoreBuildTools `
            --add Microsoft.VisualStudio.Workload.WebBuildTools
          # 按需添加其他工作负载,比如C++项目加:--add Microsoft.VisualStudio.Workload.VCTools
        shell: pwsh

      - name: 将MSBuild路径加入环境变量
        run: |
          echo "C:\Program Files\Microsoft Visual Studio\2026\BuildTools\MSBuild\Current\Bin" | Out-File -FilePath $env:GITHUB_PATH -Encoding utf8 -Append
        shell: pwsh

      - name: 验证MSBuild版本
        run: msbuild -version

      - name: 执行项目构建
        run: msbuild YourSolution.sln /p:Configuration=Release

关键步骤说明

  • 下载引导程序:通过官方链接获取VS2026 Build Tools的安装程序,确保获取的是最新稳定版。
  • 静默安装:使用--quiet--wait参数实现无交互安装,避免中断CI流程;通过--add指定项目必需的工作负载,减少不必要的安装内容以节省时间。
  • 配置环境变量:将MSBuild的可执行文件路径加入PATH,确保后续步骤能直接调用msbuild命令。

方法二:使用Chocolatey包管理器

如果Chocolatey已提供Visual Studio 2026 Build Tools的包,可通过以下方式快速安装:

GitHub Actions配置片段

- name: 安装Chocolatey并获取VS2026 Build Tools
  run: |
    Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
    choco install visualstudio2026buildtools --package-parameters "--add Microsoft.VisualStudio.Workload.MSBuildTools --quiet"
  shell: pwsh

注意:此方法依赖Chocolatey包的更新时效性,若官方包未及时同步VS2026版本,建议优先使用方法一。

注意事项

  • 安装过程耗时较长,确保GitHub Actions作业的超时时间(默认6小时)足够覆盖安装和构建流程。
  • 根据项目类型调整工作负载:比如C++项目需添加Microsoft.VisualStudio.Workload.VCTools,桌面.NET项目需添加Microsoft.VisualStudio.Workload.ManagedDesktopBuildTools等。
  • 若安装失败,可在命令中移除--quiet参数查看详细日志,排查问题。

内容的提问来源于stack exchange,提问作者Amit

火山引擎 最新活动