必须强烈推荐这个节点！！！让我 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/（需建）
-
-
设置环境变量：
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 都打通，但记得“环境干净 ≠ 成就高”。
💡 > 欢迎分享文章，或是 来信 与我交流