Jenkins无法定位本地Git，配置路径后仍提示The recommended git tool is: NONE

1. 修正Git路径配置，避免两处冲突 #

• 优先仅在Global Tool Configuration中配置Git路径，将Configure System页面下的Git相关路径留空，两处同时配置会出现优先级冲突，导致识别失败。
• 验证配置的路径有效性：在Jenkins运行环境的终端中，直接执行你填写的完整Git路径加--version参数，比如Windows环境执行"C:\Program Files\Git\bin\git.exe" --version，Linux/macOS环境执行/usr/bin/git --version，确认可以正常输出版本号，没有权限报错、路径不存在提示。
• 路径填写注意事项：
  • Windows环境必须填写git.exe的完整路径，不要填git-bash.exe，优先选择bin目录下的git.exe而非cmd目录下的对应文件；带空格的路径不要额外加引号，直接填写完整路径即可。
  • Linux/macOS环境可以先执行which git获取真实的Git可执行文件路径，确认填写的路径和输出完全一致，同时确认Jenkins运行用户对该路径有执行权限。

2. 检查任务级别的Git配置 #

• 自由风格任务：进入报错任务的配置页面，找到「源码管理」板块，选择Git后找到Git executable下拉框，确认选择的是你在全局工具配置中自定义命名的Git实例，而非「无」。
• 流水线（Pipeline）任务：需要在Jenkinsfile中显式声明使用你配置的Git工具，参考写法如下：

pipeline {
  agent any
  tools {
    // 引号内的名称要和Global Tool Configuration中填的Git工具名称完全一致
    git '你的Git工具命名'
  }
  stages {
    stage('拉取代码') {
      steps {
        git url: '代码仓库地址', branch: '主分支名称'
      }
    }
  }
}

3. 重载配置并重启Jenkins #

• 旧版本Jenkins存在配置缓存不生效的问题，修改配置后可以进入Manage Jenkins >> Reload Configuration from Disk重载配置，或者直接重启Jenkins服务，重启后再次运行任务验证。

4. 检查插件兼容性 #

• 进入Manage Jenkins >> Plugins页面，检查Git插件是否和当前Jenkins核心版本兼容，过旧的Git插件会出现无法识别全局配置的问题，升级到对应Jenkins版本支持的最新稳定版Git插件即可解决。

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