知仓学习社知仓学习社
报错 Microsoft Visual C++ 14.0 or greater is required（节点依赖需要现场编译 C++ 扩展） / 全站资源搜索
搜索 更新 2026-10-02
报错 030 依赖缺失与自定义节点安装失败 有来源可查

报错 Microsoft Visual C++ 14.0 or greater is required（节点依赖需要现场编译 C++ 扩展）

报错原文（原样） 
building 'insightface.thirdparty.face3d.mesh.cython.mesh_core_cython' extension
error: Microsoft Visual C++ 14.0 or greater is required. Get it with "Microsoft C++ Build Tools": https://visualstudio.microsoft.com/visual-cpp-build-tools/
[end of output]
note: This error originates from a subprocess, and is likely not a problem with pip.
ERROR: Failed building wheel for insightface
Failed to build insightface
ERROR: Could not build wheels for insightface, which is required to install pyproject.toml-based projects
检索关键词 Microsoft Visual C++ 14.0 or greater is required、Microsoft C++ Build Tools、Failed building wheel for、Could not build wheels for、error: subprocess-exited-with-error、RuntimeError: Error compiling objects for extension
先看这一句 通过 Manager 或 pip 安装某节点时，日志最后是 Failed building wheel / Could not build wheels，中间夹着一行 Microsoft Visual C++ 14.0 or greater is required；节点装不上，界面里也就没有它的节点。
适用版本 全版本通用；仅 Windows 需要 MSVC（Linux 需要 gcc/g++ 与对应开发包） · 核实日期 2026-09-26 · 状态 已核实
适用环境：Windows 便携版、秋叶/绘世整合包、ComfyUI Desktop

现象与触发场景

常见触发场景：

  • 安装 insightface（ReActor / IPAdapter 人脸）、groundingdino（ComfyUI-RMBG、SDPose）等只发源码包的依赖
  • 装完 Build Tools 仍报同样错误（组件没选全或没在同一个环境生效）
  • Windows + Python 3.12 上节点 requirements.txt 强制从 git 源码安装

根因

  • 这些依赖没有 Windows 预编译轮子，pip 只能现场编译 C/C++/CUDA 扩展，而系统没有 MSVC 编译器（Microsoft C++ Build Tools）
  • 装了 Build Tools 但没勾选 “使用 C++ 的桌面开发”/Windows SDK，编译器实际不可用
  • 在隔离构建环境里编译时找不到 torch 等包，会同时报 ModuleNotFoundError: No module named 'torch' 与编译错误

解决步骤

已按「最可能有效」排序。请从上往下做，每做完一步用「验证」确认，不要一次改五处。

  1. 优先改用预编译 wheel，避免现场编译
    这是最省事的路线。例如 GroundingDINO 有社区预编译轮子，报告者用它成功绕过了编译失败；insightface 同理有 cp312 的 Windows 轮子。注意必须匹配你的 Python 版本（cp310/cp312 不能混用）并用 ComfyUI 自带解释器安装。
    ..\..\python_embeded\python.exe -m pip install <预编译 whl 的本地路径>
  2. 确实需要编译时，安装 Microsoft C++ Build Tools
    按报错里给出的地址安装 Visual Studio Build Tools，安装时勾选“使用 C++ 的桌面开发”（含 MSVC 编译器与 Windows SDK），装完重启命令行与新开的终端，再用 ComfyUI 解释器重试安装。
  3. 把结论回写给节点作者（更新 requirements.txt）
    这是节点侧的真问题：requirements.txt 在 Windows 上强制从 git 源码安装，会让所有没有编译环境的用户都装不上。可在节点仓库提 issue 建议：Windows 环境检测后改用预编译轮子，或提供 install.py 处理二进制安装。

验证是否修好

重新执行安装，日志不再出现 Failed building wheel / Microsoft Visual C++ 14.0 报错；重启 ComfyUI 后该节点出现在界面里且能执行。

补充说明

多个真实 issue 都显示：只装 Build Tools 不一定立即解决（有人装完仍报同样错误），所以推荐顺序是“先找预编译轮子，再考虑装 Build Tools”。

来源

按可信度排列：官方 issue / 官方文档 > 节点仓库 issue > 社区帖 > 中文社区文章。 链接以纯文本给出（本站不做站外跳转），需要核对时请自行复制到浏览器打开。
  1. [82] （节点仓库 issue）　Error building insightface? · Issue #14 · ZHO-ZHO-ZHO/ComfyUI-InstantI　https://github.com/ZHO-ZHO-ZHO/ComfyUI-InstantID/issues/14
  2. [83] （社区）　Building wheel for insightface (pyproject.toml): finished with status 　https://github.com/deepinsight/insightface/issues/2696
  3. [84] （节点仓库 issue）　[Windows/Python 3.12] Critical Installation Failure: GroundingDINO Dep　https://github.com/judian17/ComfyUI-SDPose-OOD/issues/27

本条报错提到的节点仓库

下面这些节点仓库的名字出现在本条报错的正文里。这里只说「名字出现过」，没有断定问题就是它引起的； 点进去可以看这个包的用途、适配模型与下载量。

1038lab/ComfyUI-RMBG 节点库

这条报错要用到的东西

按本条报错所属的类别（依赖缺失与自定义节点安装失败）列出站内相关的下载包与板块入口。 它们不是「必须下载才能修好」，而是这一类问题里最常要动到的东西；具体怎么做，以上面的解决步骤为准。

常用节点速查包常用节点参数小抄 / 常见连法示意图 待挂载
节点库按用途找节点仓库，附适配模型与下载量 板块

同一类别的其他条目

【023】报错 No module named 'insightface'（IPAdapter 人脸加载器 / ReActor 换脸节点不可用） 有来源 【024】一个节点包报错导致 / 或看似导致所有自定义节点加载中断（Cannot import ... custom_nodes） 有来源 【025】报错 No module named 'cv2'（controlnet_aux / WanVideoWrapper 等节点导入失败） 有来源 【026】报错 ImportError: DLL load failed while importing onnxruntime_pybind11_state（缺 Visual C++ 运行库 / onnxruntime 版本不匹配） 有来源 【027】报错 ImportError: cannot import name 'cached_download' from 'huggingface_hub'（diffusers 与新版 huggingface_hub 不兼容） 有来源
这个解法对你有效吗 记录只存在你自己的浏览器里，不需要注册账号。

返回报错库