Windows 10执行git-clang-format提示Python未找到的解决方法

原因分析 #

git-clang-format本质是Python脚本，它调用Python的方式可能和你系统路径里的Python实例不匹配——比如脚本默认找python命令，但你的Windows环境里Python可能只有python3.exe或带版本号的可执行文件，导致脚本无法识别。

具体解决方法 #

1. 给Python创建python.exe别名 #

Windows下可以通过软链接让系统识别python命令：

• 以管理员身份打开命令提示符（CMD）
• 进入你的Python安装根目录（比如C:\Python311）
• 执行命令：mklink python.exe python3.exe
  完成后再运行git clang-format -h测试。

2. 修改git-clang-format脚本的Python路径 #

找到LLVM的bin目录下的git-clang-format文件（纯文本脚本），用编辑器打开：

• 将第一行的#!/usr/bin/env python替换为你Python可执行文件的完整路径，比如#!C:\Python311\python.exe
• 保存文件后重新执行git clang-format -h

3. 调整环境变量优先级 #

Git自带的环境可能覆盖系统路径，导致脚本找不到你的Python：

• 打开系统环境变量设置，找到Path变量
• 将Python的安装目录（比如C:\Python311）移到Git相关路径的上方
• 重启命令提示符或Git Bash后测试

4. 直接指定Python路径调用脚本 #

如果以上方法都无效，可直接用Python运行git-clang-format脚本：

python "C:\Program Files\LLVM\bin\git-clang-format" -h

也可以把这个命令做成批处理文件，方便日常使用。

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