Maya引用文件无法加载：Reference Editor常见报错修复
问题概述：打开镜头后角色引用红色、离线或出现 unresolved reference。
这类问题最容易被“反复重启、盲目加采样或直接删除节点”掩盖。可靠的处理方式是先复制工程，在可回退的副本中建立最小测试，再一次只改变一个变量。
常见原因
- 源文件路径变化
- 嵌套引用断链
- 命名空间冲突
- 引用编辑记录指向已删除节点
推荐解决步骤
- 在 Reference Editor 中查看实际 unresolved path，不要只看弹窗
- 先修复最底层资产，再加载上层嵌套引用
- 用 File Path Editor 或 Replace Reference 指向正确版本
- 检查 namespace 是否唯一，避免手动改引用内部节点名
- 对失效 reference edits 先导出记录，再移除明确无效的编辑
如何确认已经修好
关闭并重新打开镜头，所有引用自动加载，且 Reference Editor 无红色条目。
容易踩的坑
不要在唯一工程文件上直接清理、解绑或覆盖保存；不要同时修改多个设置，否则即使结果变好，也无法知道真正起作用的是哪一步。涉及插件、渲染器和颜色管理时，还应记录 Maya 版本、插件版本、操作系统和项目单位。
官方参考
菜单名称和默认值可能随版本变化，可结合 Autodesk Maya 官方帮助核对当前版本。
本文为喵喵动画屋整理的实战排错清单。建议先在副本中测试，再应用到正式项目。
