ComfyUI-BrushNet模型路径配置完整指南

ComfyUI-BrushNet作为一款强大的即插即用图像修复工具，其模型文件的正确存放位置对于功能实现至关重要。本文将提供最完整的路径配置解决方案，帮助用户轻松避开各种配置陷阱。

模型路径配置的重要性

ComfyUI-BrushNet是一款革命性的图像修复工具，其模型文件的正确配置直接决定了功能能否正常运行。通过合理的路径配置，你可以避免模型加载失败、提高工作流稳定性，并享受流畅的图像修复体验。

标准路径结构详解

经过大量实践验证，最稳定可靠的存放位置是ComfyUI主目录下的models/inpaint文件夹：

ComfyUI根目录/
├── models/
│   └── inpaint/
│       ├── diffusion_pytorch_model.safetensors
│       ├── config.json
│       └── model_index.json

文件命名与格式要求

BrushNet加载器对文件名非常友好，只需满足以下条件：

• 文件扩展名必须是.safetensors
• 文件名可自由定义，无需特定格式
• 系统自动识别所有符合条件的文件

模型文件完整性验证

为确保下载的模型文件完整无误，请核对文件大小：

模型类型	文件大小	字节数
BrushNet SD15	约2.47GB	2,475,354,520字节
BrushNet SDXL	约1.49GB	1,493,356,392字节

自定义路径配置技巧

虽然支持通过extra_model_paths.yaml文件配置自定义路径，但实际使用中可能会遇到兼容性问题。建议优先使用标准路径。

自定义路径注意事项

如果必须使用自定义路径，请牢记以下要点：

1. 确保路径配置100%准确
2. 检查文件权限设置
3. 路径中不能包含特殊字符
4. 路径层级不宜过深

配置最佳实践

1. 路径选择优先：始终优先使用ComfyUI默认的models/inpaint目录
2. 文件名保持不变：避免修改原始文件名
3. 文件统一管理：将所有模型相关文件存放在同一目录
4. 定期完整性检查：确保模型文件未损坏
5. 版本隔离存放：不同版本模型存放在不同子目录

常见问题快速解决

问题：模型加载失败怎么办？ 解决方案：首先检查是否放置在models/inpaint目录下，然后验证文件大小是否正确。

问题：自定义路径不生效？ 解决方案：建议切换到标准路径，或检查extra_model_paths.yaml配置格式。

安装与部署步骤

1. 克隆项目仓库：

git clone https://gitcode.com/gh_mirrors/co/ComfyUI-BrushNet

2. 将下载的模型文件放置在正确目录：

ComfyUI/models/inpaint/

3. 启动ComfyUI并加载BrushNet节点

功能特性展示

ComfyUI-BrushNet支持多种图像处理功能，包括对象移除、局部修复、风格迁移等。通过合理配置模型路径，你可以充分发挥其强大的图像修复能力。

通过遵循这份完整的配置指南，你可以确保BrushNet模型能够被正确加载和使用，充分体验其强大的图像修复功能。