ComfyUI依赖安装指南：快速配置Python环境
ComfyUI依赖安装指南：快速配置Python环境
在本地部署AI工具链时，最让人卡住的往往不是模型运行，而是第一步——环境搭建。特别是像ComfyUI这类基于Python的可视化节点式AI工作流引擎，虽然功能强大、扩展灵活，但若依赖包无法正确安装，连启动界面都打不开。
别担心，只要掌握核心路径和关键命令，整个过程可以压缩到几分钟内完成。本文聚焦实战操作，带你绕过常见坑点，快速配好可运行的Python环境。
标准Windows发行版的ComfyUI通常自带一个便携式Python环境，位于_windows/python/_embeded目录下。这个目录里有python.exe和基础库支持，无需系统全局安装Python即可独立运行，非常适合“即解即用”的场景。
你的第一站就是找到它：
[你解压的位置]\ComfyUI\_windows\python\_embeded比如默认路径可能是：
D:\ComfyUI\_windows\python\_embeded进入该目录后，在空白处按住Shift + 右键，选择【在此处打开命令窗口】或【打开 PowerShell】，也可以直接启动 CMD 并切换过去：
cd /d D:\ComfyUI\_windows\python\_embeded接下来最关键的一步来了：使用内置 Python 调用 pip 安装主项目中的依赖文件。
执行这条命令（注意替换为你的实际路径）：
python -m pip install -r D:\ComfyUI\_windows\ComfyUI\requirements.txt📌 为什么用
python -m pip？
这是为了确保调用的是当前目录下的 Python 环境所绑定的 pip，避免因系统中存在多个 Python 版本而导致混乱。这是一种更安全、更可靠的调用方式。
如果你看到一连串包名开始下载并显示[####################] 100%，说明一切正常。但如果半天不动、频繁超时，那大概率是网络问题。
由于默认的 PyPI 源在国外，国内用户经常会遇到下载缓慢甚至中断的情况。解决方法很简单：换国内镜像源。
推荐使用清华、阿里云或豆瓣的镜像站，只需在原命令后加上-i参数：
python -m pip install -r D:\ComfyUI\_windows\ComfyUI\requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple这是目前最稳定高效的组合之一。其他常用镜像如下：
| 镜像源 | 地址 |
|---|---|
| 清华大学 | https://pypi.tuna.tsinghua.edu.cn/simple |
| 阿里云 | https://mirrors.aliyun.com/pypi/simple |
| 豆瓣 | https://pypi.douban.com/simple |
⚠️ 注意：部分镜像可能不同步预发布版本（如
--pre包），如果提示找不到某个开发版依赖，尝试关闭镜像或更换为官方源。
还可以进一步增强稳定性，增加超时时间和重试次数：
python -m pip install -r D:\ComfyUI\_windows\ComfyUI\requirements.txt \ --timeout 1000 \ --retries 10 \ -i https://pypi.tuna.tsinghua.edu.cn/simple这样即使网络波动也能大概率顺利完成安装。
当然，过程中难免会遇到报错。以下是几个高频问题及应对策略。
❌ 报错：No module named 'pip'
这表示内置的 Python 环境没有携带 pip 组件——虽然少见，但在某些精简打包版本中确实存在。
先尝试激活 pip：
python -m ensurepip --upgrade如果提示找不到模块，则需要手动安装。下载get-pip.py脚本：
curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py python get-pip.py完成后就能正常使用pip命令了。
❌ 报错：Could not find a version that satisfies the requirement
通常是以下原因导致：
- 网络连接失败
- 依赖版本约束太严格（如固定到某次提交）
- 镜像源未同步最新包
解决方案分三步走：
- 升级 pip 到最新版：
python -m pip install --upgrade pip更换镜像源（见上文）
如仍失败，可临时跳过依赖检查进行安装（仅用于调试）：
python -m pip install --no-deps -r D:\ComfyUI\_windows\ComfyUI\requirements.txt⚠️ 警告：
--no-deps不会安装依赖项之间的子依赖，可能导致后续运行时报错。建议仅作为初步验证手段，之后再逐个补全缺失包。
❌ 报错：ERROR: Cannot uninstall 'xxx'. It is a distutils installed project
常见于setuptools、wheel等底层包冲突。因为这些包最初由 distutils 安装，pip 无法安全卸载。
两种处理方式：
方式一：强制重装所有依赖
python -m pip install -r D:\ComfyUI\_windows\ComfyUI\requirements.txt --ignore-installed这会忽略已安装状态，重新覆盖所有包，适合彻底重建环境。
方式二：单独处理冲突包
例如只强制更新 setuptools：
python -m pip install setuptools --force-reinstall --no-deps然后再继续完整安装流程。
GPU加速配置（CUDA/cuDNN）
ComfyUI 的性能优势在于能利用 GPU 加速图像生成任务。默认情况下，PyTorch 会尝试启用 CUDA，但有时会失败。
检查当前环境是否识别到 GPU：
python -c "import torch; print(torch.cuda.is_available())"如果输出False，但你明明有 NVIDIA 显卡，那很可能是安装了 CPU 版本的 PyTorch。
此时应卸载原有版本，并指定 CUDA 版本重新安装：
python -m pip uninstall torch torchvision torchaudio python -m pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu118根据你的驱动支持情况选择合适版本：
- CUDA 11.8 →cu118
- CUDA 12.1 →cu121
查看当前显卡驱动支持的最高 CUDA 版本：
nvidia-smi右上角会显示类似CUDA Version: 12.4，这意味着你可以安装cu121或更低版本的 PyTorch（注意：不是越高越好，要匹配可用 wheel）。
启动验证与自定义节点扩展
依赖安装完成后，回到 ComfyUI 根目录，尝试运行主程序：
D:\ComfyUI\_windows\ComfyUI\main.py或者双击根目录下的run.bat文件。
如果浏览器自动打开http://127.0.0.1:8188并显示节点编辑界面，恭喜你，环境已经成功跑起来了！
自定义节点怎么装？
ComfyUI 的真正魅力在于其插件生态。许多高级功能（如控制网、动画生成、模型管理）都通过custom nodes实现。
以 ComfyUI-Custom-Scripts 为例：
- 克隆仓库到
custom_nodes目录：
cd D:\ComfyUI\_windows\ComfyUI\custom_nodes git clone https://github.com/pythongosssss/ComfyUI-Custom-Scripts.git- 安装其专属依赖：
D:\ComfyUI\_windows\python\_embeded\python -m pip install -r ComfyUI-Custom-Scripts\requirements.txt💡 原则：只要有
requirements.txt，就要在同一 Python 环境中执行安装，否则节点将无法加载。
进阶建议：使用虚拟环境统一管理（专业用户）
尽管 ComfyUI 自带 Python，但在多项目协作或开发调试时，建议使用虚拟环境（venv）来隔离依赖。
创建专用环境：
python -m venv C:\envs\comfyui C:\envs\comfyui\Scripts\activate pip install -r D:\ComfyUI\_windows\ComfyUI\requirements.txt然后修改run.bat中的 Python 路径指向虚拟环境的python.exe，例如：
C:\envs\comfyui\Scripts\python.exe main.py这样做有几个好处：
- 避免_embeded环境被污染
- 方便调试和日志追踪
- 支持跨项目共享一致依赖版本
到现在为止，你应该已经顺利完成了 ComfyUI 的依赖安装，并具备了基本的问题排查能力。
回顾一下最关键的命令模板：
python -m pip install -r [ComfyUI路径]\requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple --timeout 1000 --retries 10配合镜像加速和错误处理策略，即使在网络受限环境下也能高效完成部署。
ComfyUI 正成为越来越多创作者和团队构建 AI 生成管道的核心工具。它不只是一个图形界面，更是一种可复用、可编排、可分享的工作流范式。而这一切的前提，就是一个干净、稳定、完整的运行环境。
现在，你已经迈出了最关键的第一步。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考