ComfyUI 开荒报错：补齐缺失的 C++ 编译器

现象描述

刚把 ComfyUI 跑起来，控制台就开始报红字。仔细看日志，会发现卡在 Installing xtcocotools 或者 pycocotools 这一步，最后抛出一个关于 Microsoft Visual C++ 的错误代码。

根因分析

这件事挺绕的，但逻辑很直接。

ComfyUI 很多好用的功能（比如自动抠图、掩码处理）依赖一些底层插件。这些插件是用 C++ 语言写的。Python 在安装它们时，需要调用电脑里的 C++ 编译器 把源码翻译成二进制文件。

Windows 系统默认是不带编译器的。如果你是新电脑，或者没搞过 C++ 开发，系统里就没有这个“翻译官”。Python 找不到人干活，安装任务就直接报错崩掉了。

修复方案

我们得给 Windows 装上这个编译器。

Step 1: 获取 Build Tools

去微软官网下载 Visual Studio Build Tools。别下错了，我们要的是轻量级的“生成工具”，不是完整的 Visual Studio 开发集成环境。

Step 2: 关键勾选 (别全选)

打开下载好的安装程序，你会看到一堆复选框。全选会吃掉你几十 GB 硬盘空间，完全没必要。

只勾选这一项：

• 使用 C++ 的桌面开发 (Desktop development with C++)

右侧的子选项保持默认即可。

Step 3: 耐心等待

点击安装。这个过程会下载大概 2-5GB 的数据，根据你的网络情况，可能需要 20 分钟到 1 小时。如果下载失败，建议挂个代理或者换个网络时段再试。

Step 4: 重启 ComfyUI

安装完成后，必须重启电脑（或者至少重启所有终端窗口）。

重新运行 ComfyUI 的启动脚本。此时系统会自动再次尝试安装那些报错的插件。有了编译器的支持，这次 xtcocotools 应该能顺利跑通。

坑位提醒

1. 磁盘空间：虽然只选了一项，安装完也要占用 6-9GB 空间，C 盘太小的同学注意预留位置。
2. 版本问题：如果系统提示你版本冲突，先卸载旧版的 Visual C++ Redistributable，再跑这个安装程序。
3. 安装慢：如果进度条不动，那是微软服务器的问题。关掉重来，或者换国内镜像节点。