ComfyUI 模型放哪里、节点怎么安装:models 文件夹、共用模型路径与自定义节点

ComfyUI 模型放哪个文件夹?怎么和 WebUI 共用模型?自定义节点怎么装、装不上怎么办?本文按官方中文文档讲清 models 目录结构、extra_model_paths.yaml 的写法、三种节点安装方式和官方的安全提醒。

NNathaniel bigo··原创首发·AI 辅助撰写
8 分钟读完
资料核对于 2026-10-11 · 依据官方文档与公开资料整理 免费账号 账号

适用于谁

  • 搜「comfyui 模型放哪里」「comfyui安装模型」「comfyui 节点安装」「comfyui 安装缺失节点」的人;
  • 下载了模型但在节点里选不到,或者导入别人的工作流后一片红色报错的人。

本文根据 ComfyUI 官方中文文档整理,资料核对于 2026-10-11。还没装 ComfyUI 的话先看《ComfyUI 安装教程》。

结论先说

  1. 模型按类型放进 ComfyUI/models/ 下的对应子文件夹:大模型放 checkpoints,LoRA、VAE、ControlNet 各有各的文件夹。放错文件夹,对应的加载节点里就看不到。
  2. 放好之后要刷新:在界面里按 R 键,或重启 ComfyUI。
  3. 想和别的软件共用模型,不用复制文件:用 extra_model_paths.yaml 把外部目录登记进来(桌面版在「存储」标签页里添加)。
  4. 自定义节点优先用 ComfyUI Manager 装,它会自动处理依赖。
  5. 自定义节点是别人写的代码,有安全风险。官方明确提醒只安装来自可信作者、社区常用的节点。

模型放哪里

默认目录

官方文档说明:模型默认存放在 ComfyUI/models/ 下,按用途分成子文件夹,ComfyUI 启动时会检测这些文件夹。常见的几类:

模型类型文件夹作用
Checkpoint(主模型)models/checkpoints负责生成画面的主扩散模型
LoRAmodels/loras针对某种风格、角色或概念训练的轻量附加权重
VAEmodels/vae图像与潜空间之间的编解码
ControlNetmodels/controlnet用线稿、深度、姿态等引导构图
放大模型models/upscale_models提高分辨率
Embeddingmodels/embeddings文本嵌入

不同安装方式下 models 的实际位置:

  • 便携版:ComfyUI_windows_portable/ComfyUI/models/;
  • 桌面版:点应用顶部的胶囊菜单,打开 存储(Storage) 标签页可以看到模型目录,点文件夹图标直接在文件管理器里打开。官方注明这个菜单只在桌面应用里有,用浏览器访问的网页版没有。

有些较新的模型不是一个文件,而是拆成扩散模型、文本编码器、VAE 几个文件,各自放在不同的子文件夹。这种情况以该模型的官方工作流模板或说明页里写的路径为准。

使用模型的四步

官方文档的顺序:

  1. 把文件放到正确的位置;
  2. 在工作流里添加对应的加载器节点。这类节点名称里通常带 Load(如 Load Checkpoint、Load LoRA);
  3. 在加载器节点的下拉菜单里选择文件;
  4. 把加载器连进工作流的其余部分。

ComfyUI 开着的时候放进去的文件,需要按 R 刷新或重启才会出现在列表里。

删除模型

官方说明目前界面里没有统一的「卸载」入口,要移除某个模型,到 ComfyUI/models/ 下找到对应文件手动删除。

和其他软件共用模型

如果你已经有一批模型放在别处(比如另一个 ComfyUI 实例,或者 WebUI 的模型目录),不需要再复制一份。

便携版和手动安装

  1. 在 ComfyUI 根目录找到示例文件 extra_model_paths.yaml.example;
  2. 复制一份并改名为 extra_model_paths.yaml,仍放在 ComfyUI 根目录;
  3. 按你的实际目录填写。官方给的示例:假设外部模型在 YOUR_PATH/models/ 下,分 loras、checkpoints、vae、controlnet 几个子文件夹,配置写成:
yaml
my_custom_config:
    base_path: YOUR_PATH
    loras: models/loras/
    checkpoints: models/checkpoints/
    vae: models/vae/
    controlnet: models/controlnet/

base_path 是外部目录的根路径,下面每一行是「模型类型: 相对路径」。第一行的名字可以自己取。

  1. 保存后重启 ComfyUI。

桌面版

点顶部的胶囊菜单 → 存储(Storage) 标签页,在里面添加模型目录即可,不需要手写配置文件。

自定义节点怎么安装

先了解风险

自定义节点是社区开发的扩展,能增加大量功能,但它们是在你电脑上运行的代码。官方文档的三条提醒:

  1. 只安装来自可信作者、社区常用的自定义节点;
  2. 安装前了解插件的功能,避开来源不明的;
  3. 不要安装冷门或可疑的插件,未经审核的插件可能带来安全风险。

三种安装方式

方式优点缺点
ComfyUI Manager(官方推荐)自动安装、自动处理依赖、图形界面搜不到没有在注册表里登记的节点
Git Clone能装注册表里没有的节点、能指定版本要会用 Git,依赖要自己装
下载 ZIP不需要 Git依赖要自己装,没有版本管理

方法一:ComfyUI Manager

官方说明 ComfyUI Manager 已经内置在当前大多数 ComfyUI 发行版中,桌面版用户默认启用新版的节点管理界面。打开 Manager,搜索节点名称,点安装,完成后按提示重启。

导入别人的工作流后出现红色的缺失节点,也是在 Manager 里处理:它提供安装缺失节点的入口,会列出当前工作流缺少的节点供你一键安装(具体按钮名称以你的版本界面为准)。

方法二:Git Clone

bash
cd /path/to/ComfyUI/custom_nodes
git clone [仓库地址]

然后安装依赖。官方特别强调:依赖必须装进 ComfyUI 自己的 Python 环境,不要装到系统环境里。Windows 便携版的写法是:

bash
python_embeded\python.exe -m pip install -r ComfyUI\custom_nodes\[节点目录]\requirements.txt

手动安装的环境则是先激活 ComfyUI 的虚拟环境,再在节点目录里执行 pip install -r requirements.txt。

方法三:下载 ZIP

在节点的 GitHub 页面下载 ZIP,解压到 ComfyUI/custom_nodes 下,再按方法二安装依赖。

三种方式装完都要重启 ComfyUI 并刷新浏览器。

常见问题

Q:节点安装失败、装完不显示?

官方的排查方法是看启动日志里有没有 import failed。出现这个提示,多半是依赖没装上,或者装到了错误的 Python 环境里。先读该节点 README 里的安装说明和依赖要求,再按上面的命令在 ComfyUI 的环境里重装依赖。

Q:模型放进去了,节点里还是没有?

按顺序检查:文件夹对不对(LoRA 放进了 checkpoints 是最常见的错误);有没有按 R 刷新或重启;文件是否下载完整;用了 extra_model_paths.yaml 的话,文件名、缩进和路径是否正确。

Q:自动下载模型一直不动?

官方文档说明,自动下载通常从 Hugging Face 拉取,需要网络能正常访问。不动的话,从缺失模型的提示里复制下载链接,自己下载后放进对应文件夹。

Q:所有模型都能在 ComfyUI 里直接用吗?

不是。官方的说法是:原生支持的模型数量有限但在持续增加;另一部分模型依赖社区的自定义节点才能用,不同作者的模型路径和用法可能不一致,要读各项目自己的说明。

Q:工作流文件放哪里?

工作流是 JSON 文件,也可以从带元数据的图片里读取。用菜单的 工作流 → 打开 加载即可,不要求放在固定的文件夹。

参考资料

  • ComfyUI 文档:模型 — https://docs.comfy.org/zh-CN/development/core-concepts/models
  • 适用于 Windows 的 ComfyUI 便携版(添加外部模型路径)— https://docs.comfy.org/zh-CN/installation/comfyui_portable_windows
  • 如何在 ComfyUI 中安装自定义节点 — https://docs.comfy.org/zh-CN/installation/install_custom_node
  • 开始 ComfyUI 的 AI 绘图之旅 — https://docs.comfy.org/zh-CN/get_started/first_generation

Nathaniel 的更多内容

  1. 01

    promptfoo 使用教程:对比提示词和模型、写断言自动评测(安装与配置)

    promptfoo 是什么、怎么使用?按官方 README 和入门文档讲清它的用途、三种安装方式、用示例项目起步、promptfooconfig.yaml 里提示词、模型和测试用例三部分怎么写、常用断言类型的含义、eval 与 view 两条命令,以及把它放进日常改提示词流程的方法。

    ChatGPT其他 AI 工具0
  2. 02

    Kimi API怎么用:API Key获取、Python调用、K3价格与429报错处理

    Kimi API Key 在哪里获取、怎么用 Python 调用 K3、价格怎么算、429 和 401 报错怎么办?本文按 Kimi API 开放平台官方文档讲清注册认证、创建 Key、base_url 与模型名、计费规则和常见错误排查。

    Kimi0
  3. 03

    Cursor Agent 模式怎么用:Agent、Plan、Ask 三种模式,检查点回滚与消息排队

    Cursor Agent 模式是什么、和 Plan / Ask 模式怎么选?按官方文档讲清 Agent 能调用哪些工具、Shift+Tab 切换模式、Plan 模式先出方案再动手、用检查点撤销改动、任务进行中排队或插话,以及 /goal 长目标。

    Cursor0
  4. 04

    Gemini 聊天记录怎么导出:导出到文档 / 表格、生成 PDF 与用 Takeout 批量导出完整对话

    Gemini 没有「一键导出全部对话」的按钮,但有三条官方路径:单条回答导出到 Google 文档、Gmail、表格;让 Gemini 直接生成 PDF、Word、Markdown 文件;用 Google Takeout 批量下载全部活动记录。本文给出每种方法的步骤和限制。

    Gemini0
  5. 05

    ChatGPT 生成图片中文乱码、文字错误怎么办:7 个按顺序试的办法

    让 ChatGPT 做海报、封面、信息图,中文总是缺笔画、错字、乱码?本文按 OpenAI 官方图像提示指南,给出从写法、字数、局部修改、质量档位到后期排版的 7 个办法,以及什么时候干脆别让 AI 写字。

    ChatGPT0
  6. 06

    OpenCode Skills 使用指南:技能目录、命名规则、权限配置与不加载排查

    OpenCode 的 Skills 放在哪个目录、怎么控制哪些技能能用?按 OpenCode 官方文档讲清六个扫描位置、name 的正则规则、skill 工具的工作方式、在 opencode.json 里用 allow / deny / ask 配置权限、按智能体覆盖,以及技能不出现时的五项检查。

    其他 AI 工具0

同产品的其他教程

  1. 01

    MinerU 是什么、怎么用:把 PDF 等文档解析成 Markdown(4.0 的安装、四档解析与命令)

    MinerU 是什么、怎么安装使用?按官方中文 README 讲清 4.0 版本的定位、支持的输入与输出格式、flash / basic / standard / advanced 四档解析各适合什么、pip 安装命令、mineru-kit 与 mineru 两个命令的分工和常用写法,以及从旧版升级要注意什么。

    其他 AI 工具0
  2. 02

    npx skills add 怎么用:从 GitHub 安装 Skill、skills.sh 是什么与常用命令

    网上的 Skill 安装命令大多是 npx skills add 开头,它是什么、装到哪去了?按官方 README 讲清 skills 命令行工具支持的来源写法、项目与全局两种范围、-a 指定工具、list / find / update / remove 等命令、软链接与复制的区别,以及怎么关掉遥测。

    Claude其他 AI 工具0
  3. 03

    即梦首尾帧怎么用:两张图生成过渡视频(在哪里、提示词、不能用怎么办)

    即梦首尾帧在哪里、怎么用?本文讲清首尾帧入口、哪些模型支持、两张图的比例要求、过渡提示词怎么写,以及「首尾帧不见了 / 不能用了」「画面跳变」的原因和解决办法。

    其他 AI 工具0
  4. 04

    DeepSeek怎么用:网页版与手机App入门(深度思考、智能搜索、上传文件)

    DeepSeek怎么用?本文从官方入口和登录方式讲起,说清输入框里的「深度思考」「智能搜索」和上传附件各管什么,历史对话怎么改名、置顶、分享和导出,以及手机上使用的注意点。

    其他 AI 工具0
  5. 05

    文心一言网页版怎么用:改名「文心」后的入口、对话与工作任务、PPT生成

    文心一言现在叫什么、网页版入口在哪、怎么用?本文按百度文心官网和 App Store 官方页面讲清「文心」的新入口、对话与工作两种模式、图片生成和帮我写作、任务托管与 AIPPT、知识库和定时任务从哪开始。

    其他 AI 工具0
  6. 06

    Trae 规则与 MCP 配置教程:.trae/rules 四种生效方式、导入 AGENTS.md、添加 MCP Server

    Trae rules 怎么配置、Trae 怎么用 MCP?按 TRAE 官方中文文档讲清全局规则与项目规则的位置、四种生效方式、子目录与多层嵌套、导入 AGENTS.md / CLAUDE.md、提交信息规则,以及从市场添加和手动配置 MCP Server、项目级 mcp.json。

    其他 AI 工具0

0 条评论

登录 后参与评论

还没有评论,来抢沙发~