什么是 IPAdapter
IPAdapter（Image Prompt Adapter）是 ComfyUI 生态中最受欢迎的风格参考插件，它通过将参考图的特征向量注入 U-Net 的注意力层，实现无需修改 Prompt 的精准风格复现。与传统的 --sref 或图生图方案相比，IPAdapter 的风格还原度更高、生成内容更稳定。
核心节点组合
IPAdapter 的标准工作流由三个节点构成：
IPAdapter Unified Loader
↓
IPAdapter
↓
KSampler → 最终图像
| 节点 | 作用 |
|---|---|
| IPAdapter Unified Loader | 加载 IPAdapter 模型权重 |
| IPAdapter | 注入风格特征，核心控制节点 |
| IPAdapter Advanced | 提供更细粒度的掩码区域控制 |
| IPAdapter Face ID | 专门用于人脸特征迁移 |
关键参数详解
weight（风格强度）
推荐范围：0.6 ~ 0.85
过低（< 0.5）：风格感弱，参考图影响几乎不可见
过高（> 0.9）：内容被参考图主导，构图自由度丧失
最佳实践：从 0.75 开始测试，逐步微调
model_type（模型类型）
| 类型 | 适用场景 |
|---|---|
| STANDARD | 通用风格迁移，平衡内容与风格 |
| PLUS | 增强风格强度，推荐用于艺术风格 |
| PLUS FACE | 专注人脸特征，适合写真/肖像 |
| FULL FACE | 最强人脸锁定，风格迁移受限 |
start_at / end_at
控制 IPAdapter 在去噪步骤中的生效范围：
start_at: 0.0（从第一步开始）
end_at: 0.8（在最后 20% 步骤停止注入）
前期注入控制整体风格，后期停止可保留细节自然感。
与 ControlNet 联用
IPAdapter + ControlNet 是生成高质量图像的黄金组合：
[风格参考图] → IPAdapter ─────────────────→ ↘
KSampler → 成图
[结构参考图] → ControlNet（Canny/Depth）→ ↗
操作要点：
- ControlNet 负责锁定构图与空间结构
- IPAdapter 负责迁移色彩、笔触、光影风格
- 两者共享同一个 KSampler，通过
model输入合并
常见问题排查
风格不够强？
→ 将 model_type 切换为 PLUS，weight 提升至 0.8
生成内容太像参考图，缺乏创意？
→ 降低 weight 至 0.6，或缩短 end_at 至 0.7
人脸变形？
→ 改用 IPAdapter Face ID 节点，并单独控制面部权重
加载失败？
→ 确认已安装 ComfyUI-IPAdapter-plus 扩展，模型文件放置在 models/ipadapter/ 目录
小结
IPAdapter 的核心优势在于特征层面的精准风格注入，绕过了 Prompt 无法精确描述的感性风格。建议 weight 控制在 0.75 左右，搭配 ControlNet 约束结构，可稳定输出高质量风格迁移图像。进阶用户可尝试 IPAdapter Advanced 的区域掩码功能，对画面不同区域应用不同参考风格。