如何在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




