Jenkins配置CMake构建项目失败求助：找不到cmake程序

排查与修复步骤 #

1. 校验全局工具配置的CMake路径 #

• 进入Manage Jenkins -> Global Tool Configuration，找到CMake配置项
• 确认安装目录指向Jenkins服务器上实际存在的CMake可执行文件路径：Linux/Mac下通常是/usr/bin/cmake，Windows下为C:\Program Files\CMake\bin\cmake.exe
• 若选择“自动安装”，检查Jenkins是否有权限下载并写入指定目录，安装日志无报错

2. 确保任务正确关联配置的CMake #

• 打开任务配置，若使用CMake插件提供的构建步骤，必须在步骤中选择你在全局配置里定义的CMake名称，而非直接写cmake命令
• 若用shell/batch脚本调用cmake，需通过Jenkins环境变量引用配置好的路径，示例：

  # Linux/Mac
  ${PATH_TO_CMAKE} .. -DCMAKE_BUILD_TYPE=Release
  # Windows
  %PATH_TO_CMAKE% .. -DCMAKE_BUILD_TYPE=Release
  

  也可在任务的“环境变量”设置中，将CMake路径追加到PATH变量里

3. 验证代理节点的CMake安装 #

• 若任务运行在代理节点而非主节点，需确认代理节点上已安装CMake，且全局工具配置中针对该节点的CMake路径正确
• 可添加前置构建步骤，执行which cmake（Linux）或where cmake（Windows），查看输出路径是否与配置一致

4. 检查权限问题 #

• 确认Jenkins运行用户（如Linux下的jenkins用户）有权限访问CMake的安装目录及可执行文件
• 手动切换到Jenkins用户，执行cmake --version，验证是否能正常运行

极简Jenkins构建CMake项目流程（补充） #

1. 安装CMake插件（已完成）
2. 全局工具配置：
   • 新增CMake安装，选择“自动安装”或手动指定服务器路径，命名（如CMake 3.26）
3. 创建自由风格任务：
   • 源码管理：拉取项目代码
   • 构建步骤：
     • 第一步：执行shell创建build目录：mkdir -p build && cd build
     • 第二步：使用CMake插件的“CMake Build”步骤，选择配置好的CMake名称，设置源码目录为..，指定构建类型（如Release）
     • 或用shell脚本引入CMake路径后执行构建：

       source "${JENKINS_HOME}/tools/org.jenkinsci.plugins.cmakebuilder.CmakeTool/CMake 3.26/env.sh"
       cmake .. -DCMAKE_BUILD_TYPE=Release
       make -j$(nproc)
       

4. 保存任务并触发构建

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