如何在Jenkins多分支项目中使用MSBuild？解决工具未找到问题

当然可以在Jenkins多分支项目中使用MSBuild！你遇到的「未找到名为MSBuild的工具」错误，本质是Jenkins还没正确识别到MSBuild的安装路径，下面是具体的解决步骤：

1. 安装Jenkins MSBuild插件 #

首先确保你的Jenkins服务器上安装了MSBuild插件：

• 进入Jenkins的「管理Jenkins」→「插件管理」→「可选插件」
• 搜索「MSBuild」插件，勾选后点击「安装」
• 安装完成后重启Jenkins生效

2. 配置MSBuild工具路径 #

插件安装好后，需要告诉Jenkins你的MSBuild在哪里：

• 进入「管理Jenkins」→「全局工具配置」
• 找到「MSBuild」板块，点击「添加MSBuild」
  • 名称：填写MSBuild（必须和你Jenkinsfile里tool 'MSBuild'的名称完全一致）
  • 配置方式：
    • 如果你想让Jenkins自动下载安装MSBuild，勾选「自动安装」并选择对应版本；
    • 如果你已经在服务器上安装了Visual Studio，可以手动指定路径，比如VS2022 Community版的路径是C:\Program Files\Microsoft Visual Studio\2022\Community\MSBuild\Current\Bin\MSBuild.exe
  • 保存配置

3. 优化Jenkinsfile中的命令 #

另外注意一个小细节：MSBuild中Platform参数的「Any CPU」通常需要写成AnyCPU（去掉空格），否则可能会出现编译目标不匹配的问题，调整后的build阶段代码如下：

stage('build') {
    steps {
        bat "\"${tool 'MSBuild'}\" .\\src\\MySollutionName.sln /p:Configuration=Release /p:Platform=\"AnyCPU\" /p:ProductVersion=1.0.0.${env.BUILD_NUMBER}"
    }
}

同时，要确保你的Jenkins代理节点是Windows系统——因为MSBuild和bat命令都是Windows环境下的工具，如果你的代理是Linux节点，肯定无法正常运行，建议在pipeline里指定Windows节点：

agent { label 'windows' }

完成以上配置后，你的Jenkins多分支项目就能正常调用MSBuild进行编译了。

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