Manager 找不到 Git：先检查可执行文件与实例环境

现象与适用范围

适用于 Manager 安装/更新仓库时找不到 Git，或系统终端可以执行 Git、ComfyUI 进程却不可以。这里要核对的是服务进程的环境，不只是当前打开的另一个终端。

检索用原文或片段（具体编号、数值和文件名随环境变化）：

Bad git executable
git is not recognized

已核对的依据

Manager 排错文档提供 git_exe 配置用于指定 Git 可执行文件。官方节点安装也区分 Git clone 和 ZIP，两者的后续更新方式并不相同。 D04 D08

需要区分的情况

1. 机器未安装 Git 或 PATH 不含安装目录。

2. Git 是在 ComfyUI 启动后才加入 PATH，旧进程仍保留旧环境。

3. 多用户/容器/启动器环境中，ComfyUI 运行账户看不到另一账户的 Git。

建议的操作顺序

以下顺序是基于上述资料整理的诊断方案，不代表上游已经为你的环境确认了原因。

第 1 步。 在启动 ComfyUI 的同一终端执行 git --version；有输出再核对服务账户和启动方式。

第 2 步。 从 Git 官方渠道安装；若已安装但找不到，修正进程 PATH 或按 Manager 当前版本配置 git_exe 的完整路径。

第 3 步。 完全退出并重新启动服务，而不是只刷新浏览器。检查日志是否找到预期 Git。

第 4 步。 如果插件原本通过 ZIP 安装，先确认目录是否为 Git 仓库，不把它当作可直接 git pull 的副本。

如何判断处理有效

同一个服务环境能调用预期的 Git，安装或拉取命令进入正常仓库流程。认证失败、网络失败属于后续分支。

注意事项与尚未确认的部分

不要从聊天中复制全局 Git 更新引用的修复命令；这类命令可能只针对历史特定损坏。路径变更之前保存原配置。

资料核对日期：2026-09-21。本站未执行此工作流，未进行 GPU、最低显存或耗时测试。

原始资料

• D04 · ComfyUI Manager troubleshooting。核对：2026-09-21。
• D08 · Install custom nodes。核对：2026-09-21。

相关排查与操作

• ComfyUI Manager 按钮不见了：新版入口与加载失败怎么区分
• 更新与回滚 ComfyUI：先保存哪些文件和版本