SuperAPI AI 工具集

msbuild-server

部署与运维

查看项目

更新于 10-16 00:32

技能介绍

用途:MSBuild Server 用于在命令行构建之间缓存评估结果,让 CLI 构建获得与 Visual Studio 长期 MSBuild 进程相近的性能优势。

适用场景:CLI 小规模增量构建(dotnet build)比预期慢;同一项目 VS 构建快于 CLI;CI 代理对同一仓库连续执行多次构建。不适用:IDE 内构建(VS 已使用长期 MSBuild 进程);可接受冷启动开销的一次性构建;怀疑存在构建正确性问题时(应禁用服务器以隔离问题)。

使用方式:先确认是在命令行构建而非 IDE。然后设置环境变量:Bash/CI 用 export MSBUILDUSESERVER=1;PowerShell 用 $env:MSBUILDUSESERVER = "1";Windows 持久化用 setx MSBUILDUSESERVER 1。

验证:对同一项目连续运行两次构建,第一次为冷启动无缓存收益,第二次应明显更快;项目多或 Directory.Build.props 链复杂的仓库提升最明显。可用 dotnet build-server shutdown 后重新构建,确认服务器能干净重启。

限制与注意:在 Visual Studio 中不会带来收益;启用后若出现构建正确性问题,可运行 dotnet build-server shutdown 重置,问题仍存在则禁用服务器;服务器会驻留后台并可能占用内存,空闲时可用 dotnet build-server shutdown 关闭。