必须强烈推荐这个节点!!!让我 4090 跑 Flux 模型的速度有了质的飞跃!!!一张1024的图,文生图大约只需要 1.3s 左右,有图有真相,之前不能玩的工作流可以搞起来了,比如 Relux 风格迁移、Controlnet,想想就无比激动,终于不用卡硬件,可以把专注放在创作上:

需要明确的:
- 当前 ComfyUI 包用的哪个 Python 版本?
- 当前 ComfyUI 包的 torch 版本?
- 本机 VS 和 C++ 工具?
- 是不是便携包?
- nunchaku 节点版本是0.3吗,这个是当前稳定版 20250617包
如果以上条件均满足,则对应安装的轮子示例为:nunchaku-0.3.0+torch2.7-cp312-cp312-win_amd64.whl,需要在对应的ComfyUI包环境下的Python中安装,这样会防止安装环境与全局python环境的污染
我已经明确的:
- Python 版本3.12
- torch 版本2.7
- 本机 VS 和 C++ 工具 VS2022,C++
- 官方便携包ComfyUI_windows_portable Python缺头文件
- nunchaku 节点的版本是0.3
对应安装的轮子为:nunchaku-0.3.0+torch2.7-cp312-cp312-win_amd64.whl,需要在对应的ComfyUI包环境下的Python中安装,这样会防止安装环境与全局python环境的污染
✅ 总目标:
在 ComfyUI_windows_portable
的自带 Python 环境下,成功安装 nunchaku
的依赖项与 .whl
轮子,解决缺头文件/编译失败问题。
🚧 踩坑记录:
- Python.h 缺失 → 是便携包缺少
include
目录(python-dev
组件)。 - insightface 是源码构建(带 Cython 和 C++),失败点在
mesh_core_cython.cpp
。 - ComfyUI 自带 Python 不完整(无法编译 C 扩展模块)。
- VS 与 paths 设置虽全,但不被 embed Python 自动识别。
🧠 安装思路:
步骤:准备 ComfyUI 的 Python 环境
- 将你系统中安装 Python 的
Include
、libs
、Scripts
补拷进便携包:- 把官方 Python(比如 C:\Users...\AppData\Local\Programs\Python\Python312)下的:
-
Include/
-
Lib/site-packages/numpy/core/include/
-
Libs/python312.lib
-
- 分别复制到:
-
ComfyUI_windows_portable/python_embeded/Include/
-
ComfyUI_windows_portable/python_embeded/Lib/site-packages/numpy/core/include/
-
ComfyUI_windows_portable/python_embeded/Libs/
(需建)
-
- 把官方 Python(比如 C:\Users...\AppData\Local\Programs\Python\Python312)下的:
- 设置环境变量:
set DISTUTILS_USE_SDK=1 set SETUPTOOLS_USE_DISTUTILS=stdlib set CFLAGS=/IC:\你的\ComfyUI\python_embeded\Include
- 安装轮子和节点环境
cd /d D:\Downloads\ComfyUI_windows_portable_nvidia250617\ComfyUI_windows_portable\python_embeded python.exe -m pip install nunchaku-0.3.0+torch2.7-cp312-cp312-win_amd64.whl python.exe -m pip install -r ../ComfyUI/custom_nodes/ComfyUI-nunchaku/requirements.txt
🧪 测试点:
-
python_embeded/python.exe
进入 Python 解释器,测试:import nunchaku import insightface
- 启动 ComfyUI,加载 nunchaku 节点,看是否报错。
✍️ 小结一句话
- 如果你是用户主导型(内容为先),就:
👉 用秋叶包或 conda 环境,用力画图,用心创作!
- 如果你是环境控制型(掌控为先),就:
👉 把 fallbacks 都打通,但记得“环境干净 ≠ 成就高”。
💡
欢迎分享文章,或是 来信 与我交流