ComfyUI中Flux模型应放置于哪个文件夹？

Question

在使用ComfyUI部署Flux模型时，一个常见问题是：**Flux模型应放置于哪个文件夹？** 正确做法是将Flux模型文件（通常为`.pt`或`.safetensors`格式）放入ComfyUI的`models/checkpoints`目录下。此目录专为存放各类扩散模型设计，确保ComfyUI能正确加载并识别模型。若模型放置路径错误，可能导致加载失败或无法在界面中显示。此外，还需在模型加载节点中手动指定模型名称或路径，以完成调用。合理配置模型路径是实现高效图像生成与流程搭建的关键基础之一。

Answer 1

一、ComfyUI部署Flux模型时的路径配置问题

在使用ComfyUI部署Flux模型的过程中，一个常见的技术问题是：**Flux模型应放置于哪个文件夹？** 正确做法是将Flux模型文件（通常为.pt或.safetensors格式）放入ComfyUI的models/checkpoints目录下。

1.1 基础理解：ComfyUI的模型结构与路径机制

ComfyUI作为一个基于节点的工作流式图像生成工具，其内部模型管理依赖于预设的目录结构。其中，models/checkpoints目录专为存放各类扩散模型设计，确保ComfyUI能正确加载并识别模型。

1.2 深入分析：为何选择checkpoints目录？

• 该目录被硬编码在ComfyUI的模型加载逻辑中，系统会自动扫描此路径下的模型文件。
• 用户无需额外配置即可在界面中看到新添加的模型名称列表。
• 若模型放置路径错误，可能导致加载失败或无法在界面中显示。

1.3 实践操作：如何正确部署Flux模型？

1. 确认模型文件格式是否为.pt或.safetensors。
2. 进入ComfyUI安装目录下的models/checkpoints子目录。
3. 将模型文件复制或移动到该目录。
4. 重启ComfyUI服务或刷新模型缓存。
5. 在模型加载节点中手动指定模型名称或路径，以完成调用。

1.4 高级配置：自定义模型路径与环境变量设置

对于高级用户，可以通过修改ComfyUI的配置文件或设置环境变量来自定义模型搜索路径。例如，在启动脚本中加入：

export COMFYUI_MODEL_PATH=/path/to/custom/models

这样可扩展模型库的来源，但需注意路径权限和兼容性问题。

1.5 故障排查与常见错误

错误类型	可能原因	解决方法
模型未显示	模型路径错误	检查是否放在models/checkpoints目录下
加载失败	模型格式不支持或损坏	验证文件完整性，尝试其他模型版本
节点报错	路径未正确引用	在模型加载节点中手动输入模型名称或完整路径

1.6 总结建议：合理配置模型路径的重要性

合理配置模型路径是实现高效图像生成与流程搭建的关键基础之一。它不仅影响模型能否正常加载，还直接关系到后续工作流的稳定性与可维护性。

1.7 流程图展示：模型部署流程

graph TD
        A[开始] --> B{模型文件存在?}
        B -- 是 --> C[确认格式为.pt或.safetensors]
        C --> D[复制至models/checkpoints目录]
        D --> E[重启ComfyUI]
        E --> F[在节点中加载模型]
        F --> G[流程构建成功]
        B -- 否 --> H[下载或生成模型文件]
        H --> C