Nunchaku 装好了还报错：把节点、Python 库和模型权重分别核对

把几个组件分开

Nunchaku 后端 wheel、ComfyUI-nunchaku 插件和量化模型文件是不同对象。某一项安装成功，不能证明另一项可导入、加载或运行。应分别查所选版本的说明和实际启动 ComfyUI 的 Python 路径。后端安装 插件安装

python -m pip show nunchaku torch
python -c "import sys, platform; print(sys.executable, sys.version); print(platform.system(), platform.machine())"
python -m pip debug

以上命令应使用 ComfyUI 实际使用的解释器，而非仅终端默认的 Python。它们只报告环境信息，不测试原生扩展、GPU 或模型。

正确读取 wheel 名称

官方示例 nunchaku-0.3.1+torch2.7-cp311-cp311-linux_x86_64.whl 不是通用下载地址。标准 wheel 兼容标签是末尾的 Python、ABI、平台字段（此例为 cp311-cp311-linux_x86_64）；+torch2.7 属于发布版本字段，应另按发布方说明核对 Torch 构建。pip 接受 wheel 之后，原生扩展仍可能加载失败。不要通过改名绕过 pip 的标签检查。Nunchaku 安装 wheel 规范 pip debug

按故障阶段排查

1. 安装或导入： 记录失败的解释器、完整 pip/导入错误和所选 wheel。插件已加载却出现 No module named nunchaku 时，先查后端是否装进 ComfyUI 自带 Python。pip 拒绝 wheel 要核对标准标签；原生库加载失败则保留 traceback 及 Torch/CUDA/平台信息。

2. 插件与后端： 分别记录版本或提交并对照各自安装说明。插件文档明确先安装插件、再安装后端；内置 wheel 安装工作流也有版本门槛。任意挑选 wheel 或无条件升级整套 Torch 都不能替代有依据的版本组合。

3. 模型与硬件： 导入和节点注册都通过后，使用上游工作流及其预期的量化模型家族和配套文件。上游使用说明区分模型文件，并推荐 Blackwell 用 FP4、其他支持的 GPU 用 INT4；应以所选发布版本和硬件的说明为准，不把它当作普遍性能保证。模型文件或维度错误属于后续阶段。插件使用说明

完成检查与限制

在环境副本中分别确认：同一 ComfyUI 解释器安装并导入后端、预期节点已注册、目标量化模型可加载、最小上游工作流能生成。本站未安装或运行 Nunchaku 包、wheel、模型或 GPU，不声明速度或硬件兼容结果。

原始资料

• Nunchaku 后端安装。核对：2026-09-26。
• ComfyUI-nunchaku 插件安装。核对：2026-09-26。
• ComfyUI-nunchaku 使用与模型配置。核对：2026-09-26。
• Python wheel 文件名规范。核对：2026-09-26。
• pip debug 参考。核对：2026-09-26。

资料及中文语言审查：2026-09-26。文档版本和发布文件会变化；实际操作前应核对所选版本。

相关排查

• llama_cpp 缺失、编译失败和 GGUF 加载失败，应分三条路排查
• 修复 ComfyUI 前后该记什么：一份可复查的环境记录