ComfyUI汉化插件安装方法

功能说明：ComfyUI 的汉化是怎么实现的

ComfyUI 主程序本身以英文界面为主，中文化通常不是改主程序，而是加装一个"翻译类自定义节点"。它的工作方式是：为菜单、节点标题、节点输入输出端口名、以及部分自定义节点的字段提供中文映射表，加载后由前端替换显示文本。

社区中最常被使用的是 AIGODLIKE 维护的 ComfyUI 翻译扩展（仓库名 AIGODLIKE-COMFYUI-TRANSLATION），它的特点是：

• 覆盖主程序内置节点，并额外维护了一批常用自定义节点的翻译。
• 安装后在 ComfyUI 设置面板中切换语言即可生效，不需要改动主程序代码。
• 翻译表随社区更新，因此新版本 ComfyUI 刚发布时可能存在部分条目仍显示英文的情况。

需要明确一点：汉化只改显示文本，不改变节点行为、不影响出图结果，也不会提升或降低性能。

安装说明

方式一：用 ComfyUI-Manager 安装（推荐）

1. 先确保已安装 ComfyUI-Manager（它本身也是一个自定义节点，装好后 ComfyUI 界面会出现 Manager 入口）。
2. 打开 Manager，进入自定义节点安装列表。
3. 搜索关键词 Translation 或 AIGODLIKE。
4. 找到对应翻译扩展，点击 Install。
5. 完全重启 ComfyUI（不是刷新浏览器，是重启后端进程）。
6. 重启后打开设置面板，找到语言相关设置项，切换为中文。

方式二：手动 git clone

1. 关闭正在运行的 ComfyUI。
2. 进入 ComfyUI 的 custom_nodes 目录。
3. 用 git 把翻译扩展仓库克隆到该目录下，使其成为 custom_nodes/AIGODLIKE-COMFYUI-TRANSLATION 这样的一级子目录。
4. 确认目录结构正确：翻译扩展的文件应直接位于该子目录内，而不是再套一层同名文件夹。这是手动安装最常见的错误。
5. 重启 ComfyUI，进入设置切换语言。

如果本机没有 git，也可以下载仓库压缩包解压到 custom_nodes，但要注意解压后去掉多余的外层目录，并且目录名不要带 -main 之外的额外后缀导致识别异常时，可手动重命名为仓库名。

使用场景

• 新手入门：面对上百个英文节点名无法建立概念映射，中文界面能显著降低第一周的学习成本。
• 团队内部培训：给非技术背景的设计、运营同事演示工作流时，中文界面减少沟通摩擦。
• 对照学习：部分用户会在中英之间来回切换，用中文理解概念、用英文对照社区教程里的节点名。
• 不建议的场景：如果你主要跟随英文教程和英文社区排错，长期使用英文界面反而更利于搜索报错和节点名，此时不必汉化。

汉化没生效的常见原因

1. 只刷新了网页没重启后端：自定义节点在后端启动时加载，必须重启 ComfyUI 进程。
2. 目录层级多套了一层：解压后形成 custom_nodes/xxx-main/xxx/，扩展不会被识别。正确层级是扩展文件直接在 custom_nodes/<扩展名>/ 下。
3. 没有在设置里切换语言：装上不等于启用，需要手动在设置面板选中文。
4. 浏览器缓存了旧前端：重启后端后仍显示英文，可强制刷新页面或清一次站点缓存。
5. 部分条目本就没有翻译：翻译表是社区维护的，新版本主程序或小众自定义节点的新字段可能尚未收录，属于正常现象，可等待上游更新或自行补充翻译文件。
6. 与其他前端类扩展冲突：若同时装了多个修改界面的扩展，可逐个禁用定位冲突源。

本页信息来源

本页依据 ComfyUI 官方文档中关于自定义节点安装位置（custom_nodes 目录）的说明、ComfyUI-Manager 的公开使用方式，以及 AIGODLIKE-COMFYUI-TRANSLATION 仓库的公开说明整理。翻译覆盖范围与设置项名称会随上游更新变化，请以该扩展仓库 README 与你本机 ComfyUI 的设置面板实际显示为准。本页不提供版本号、文件体积与许可证信息。