报错修复
Git 不是内部命令解决：Windows 环境变量配置
修复 Windows 或终端提示 git is not recognized 的问题，讲清 Git 安装、PATH 环境变量、重启终端和 ComfyUI Manager 安装验证。
一句话结论
命令行能执行 git —version，Manager 可以 clone 插件。
这篇解决什么问题
Git 不是内部命令说明系统找不到 git.exe。ComfyUI Manager 和很多插件安装都依赖 Git。
如果你是第一次接触 ComfyUI，建议不要跳步。先把最小流程跑通，再安装插件、导入复杂工作流或追求高分辨率。ComfyUI 的大多数问题都可以通过“看控制台日志、确认目录、确认版本、降低参数”这四件事定位。
适合谁
- 刚开始使用 ComfyUI，需要一篇可以照着做的教程。
- 已经遇到相关报错，但不知道该先检查哪一步。
- 想把安装、模型、插件、工作流整理成可复查流程的用户。
准备条件
- Windows 管理员权限。
- 能下载安装 Git for Windows。
这个问题通常不是 ComfyUI 坏了，而是 Windows 找不到 Git。安装 Git 后要重新打开终端，再运行 git --version 验证。
操作步骤
- 从 git-scm.com 下载 Git for Windows。
- 安装时保留 Git from the command line and also from 3rd-party software。
- 安装完成后关闭所有旧命令行窗口。
- 重新打开 cmd，执行 git —version。
- 如果仍失败，检查环境变量 Path 中是否包含 Git\cmd。
- 回到 ComfyUI/custom_nodes 重新执行 clone 或重新用 Manager 安装。
判断问题属于哪一类
- 如果页面打不开，先看启动窗口是否还在运行，以及端口是否正确。
- 如果节点是红色，优先处理缺失自定义节点或插件加载失败。
- 如果模型下拉框为空，优先检查模型类型和放置目录。
- 如果开始生成后失败，优先看显存、模型版本和具体报错节点。
- 如果更新后才坏，优先考虑插件版本不兼容，必要时回退或临时移除插件。
常见错误
- 装完 Git 不重新打开终端。
- 安装时选择只给 Git Bash 使用。
- Path 里有旧 Git 路径导致冲突。
验证是否成功
- git —version 输出版本号。
- Manager 安装插件不再提示 git missing。
如果仍然失败
请把控制台里从 Traceback 开始到最后一行的完整报错保存下来，同时记录：ComfyUI 版本、启动方式、显卡型号、显存容量、使用的模型文件名、刚安装过哪些插件。不要只截网页上的红色提示，因为真正有用的信息通常在启动窗口里。
如果你在本站提交反馈，登录状态下会自动附带 user_id，方便后续追踪同一个用户遇到的连续问题；未登录也可以匿名提交。
下一步推荐
- 新手路线：/topics/comfyui-beginner/
- 报错排查：/topics/comfyui-errors/
- 模型基础：/topics/model-basics/
- 插件安装：/topics/must-have-plugins/
更新记录
- 2026-05-12：扩写为正式教程，补充操作步骤、常见错误和验证清单。