前言
在完成 ComfyUI 的基础环境配置后（Python、CUDA、启动器均正常），很多用户会尝试通过安装插件来扩展节点与工作流能力。然而，插件安装阶段往往成为新的'卡点'：
- 插件安装过程中反复失败
- Git 命令无法使用或找不到
- 插件依赖仓库拉取中断
这些问题看似零散，但实际上都集中在 Git 与插件获取机制 上，而并非 ComfyUI 本身配置错误。
本文将围绕 ComfyUI 插件安装过程中最常见的异常现象，重点拆解以下问题：
- Git 是否真的处于可用状态
- 插件安装失败的常见原因
- 如何判断当前环境是否具备插件安装条件
帮助你在基础环境已经稳定的前提下，正确评估插件安装失败的原因，避免无效反复排查。
本文默认你已经完成 ComfyUI 的基础环境配置，如尚未完成，可先参考相关基础环境配置说明。
一、问题一：Git 无法使用 / GitHub 插件拉取失败
在解决了 Python、CUDA 与启动器的问题之后，环境表面上已经趋于稳定，但在安装插件时，新的问题集中爆发——Git 与 GitHub 相关操作频繁失败。
这一阶段的问题，往往最消耗时间，也最容易让人误以为'前面的配置全白做了'。
1.1 现象
具体表现包括：
- 在终端中执行
git --version，提示命令不存在 - 通过绘世启动器或命令行安装插件失败
- Impact-Pack 无法安装完成
其依赖的 sam2 仓库始终无法拉取成功
![图片]
从现象上看，像是 Git、网络、Python 全部'同时出了问题'。
1.2 原因一：Git 未加入 PATH
在排查过程中，首先确认的是 Git 是否真的可用。
实际情况是：
- Git 已经安装过
- 但安装完成后，终端并未刷新
- 或 Git 路径尚未加入当前会话的 PATH
这会直接导致：
- Git 已存在，但命令行无法识别
- 启动器调用 Git 时同样失败
解决方式
最简单、也是最容易被忽略的一步：
- 完全关闭并重新打开 PowerShell / CMD
- 验证 Git 是否可用：
git --version
where git
当终端能正确输出 Git 版本号与路径时，才能确认 Git 本身没有问题。
1.3 原因二：GitHub 网络不稳定（核心问题）
在确认 Git 可用之后，Impact-Pack 的安装仍然失败，错误信息开始集中指向 GitHub 拉取阶段。
典型报错
RPC failed; curl 56 Recv failure fatal: early EOF
本质分析
这一类报错有一个非常重要的特征：
- 并非'连不上 GitHub'
- 而是 在拉取过程中连接被中断
这说明：
- GitHub 在当前网络环境下是'可访问但不稳定的'
- 尤其是：
