CLIP Vision 找不到或不兼容：它不是提示词用的文本 CLIP

现象与适用范围

参考图工作流缺少视觉编码器，或加载后在图像嵌入阶段出现维度不匹配。先确认需要的是 CLIP Vision，而不是 CLIPTextEncode 对应的文本编码器。

检索用原文或片段（具体编号、数值和文件名随环境变化）：

ClipVision model not found.
clip_vision
CLIPVisionLoader

已核对的依据

IPAdapter Plus 为不同变体列出 models/clip_vision 下的视觉编码器。固定版本的统一加载器调用 get_clipvision_file(preset) 搜索已注册文件名：VIT-G 走 bigG 分支，Kolors 有单独分支，其他预设使用偏向 ViT-H 的匹配式。没有候选时会抛出 ClipVision model not found.；文件名匹配仍不能证明权重内部架构正确。核心 CLIPVisionLoader 是另一节点，按所选文件加载并可能报告视觉模型无效；文本编码器 CLIP 不能替代它。IPAdapter README 固定版本解析源码 固定版本统一加载器 ComfyUI 核心节点

需要区分的情况

1. 实际运行实例的 clip_vision 列表里没有所需文件，或该目录放入了其他类别的权重。

2. 文件名匹配了解析式，但内容不是有效视觉模型，或其架构与适配器变体不匹配。

3. 作者推荐文件名、已安装解析式与本地文件名不一致，文件虽在目录中却未被发现。

建议的操作顺序

以下顺序是基于上述资料整理的诊断方案，不代表上游已经为你的环境确认了原因。

第 1 步。 记录确切报错和节点类，区分统一加载器的 ClipVision model not found.、核心 CLIPVisionLoader 的无效文件错误，以及后续图像嵌入维度错误。

第 2 步。 记录选中的预设和当前服务端的 clip_vision 文件列表，对照已安装解析式、发布方来源及真实文件身份；后缀、大小或改名都不足以证明配套正确。

第 3 步。 在工作流副本中用一张参考图和发布方支持的视觉编码器/适配器组合测试，暂时移除无关风格、FaceID 和多图分支。

第 4 步。 若发现文件后转为加载或维度错误，保存新的报错，检查文件完整性和架构配套；反复改名不能让错误权重变成兼容编码器。

如何判断处理有效

运行实例能发现并加载目标视觉编码器，最小参考图流程使用匹配适配器进入采样；仅找到文件还不算解决。

注意事项与尚未确认的部分

改动模型目录后应重启或刷新实际 ComfyUI 实例。固定版本解析式取第一个匹配文件，因此多个候选应明确识别。作者资源链接不等于本站已下载或校验权重。

资料及中文语言审查日期：2026-09-26。本站未下载、加载或运行视觉模型，也没有 GPU 测试或兼容保证。

原始资料

• R01 · ComfyUI IPAdapter Plus README。核对：2026-09-26。
• 固定版本视觉文件解析源码。核对：2026-09-26。
• 固定版本统一加载器。核对：2026-09-26。
• ComfyUI 核心节点。核对：2026-09-26。

相关排查与操作

• IPAdapter 模型找不到：统一加载器与手动加载器的命名规则不同
• mat1 and mat2 shapes cannot be multiplied：按模型链路查维度