Spine 图片明明存在却找不到附件？先区分占位符与附件名称

资源包里有一张武器图，运行时代码也传了一个看起来正确的名称，但角色没有切到预期武器。此时先保留现场：图片存在，只能证明文件在包中，不能证明这串名称就是运行时查找需要的键。

把三个名称写在同一条记录里

Spine 官方 Runtime Skins 文档说明，皮肤用槽位和名称定位附件，这个名称是皮肤占位符名称，不一定等于附件名。对于交接表，建议记录槽位、占位符键、最终映射附件，再把图片路径放在另一栏。

例如，下面只是用于说明的虚构映射：槽位为hand，键为weapon，当前皮肤把它映射到iron-sword附件。把iron-sword当作weapon使用是否有效，应查实际导出数据，不能从这份示例推断你的模板也使用这些名称。

先确认查询的对象，再处理查询字符串

1. 保留出问题的导出批次、当前皮肤和实际槽位，避免同时更换模型与代码。
2. 由集成负责人记录正在调用的方法、传入的槽位或索引，以及名称参数。
3. 在该批次数据中核对占位符到附件的映射，逐字符比对，不凭编辑器缩略图猜测。
4. 只在测试副本中修正一个已确认不匹配的键，再观察同一动作与皮肤。

这份清单是建议诊断步骤，不是本文已经完成的引擎实测。若查找返回了附件但仍未显示，就进入槽位状态、动画写入或渲染问题分支，不继续反复改查找名称。

不要把皮肤标签、图片路径和查找键混为一谈

如果首先失败的是皮肤选择，应先核对皮肤的真实名称；本篇只处理已经确定的附件查找对象。图片路径则交给资源加载负责人核对，它不自动成为附件查询的名称。

为减少含糊交接，请明确写“传给哪个方法的哪个参数”，而不是笼统地写“武器名错误”。错误日志也要标明是未找到槽位、未找到附件，还是纹理加载失败；不要合并成一个缺图结论。

为什么不直接把所有文件重命名

批量改名会让原来的映射、业务配置和交接记录一起变化，使问题难以复现。保留原资源副本，先用最小查询对照确定错误发生在哪层，再评估是否真的需要统一命名。存在其他引用时，名称调整应有完整引用清单与回退方案。

从工作台导出到接收项目的验收

使用Spine 工作台时，按当前教程保存所选模板与导出批次，交接真实映射记录。本文不声称工作台提供运行时查询调试器。

在接收项目验证目标皮肤、目标槽位、预期附件及一个对照皮肤；同时保留原批次仍能正常加载的证据。通过条件应是正确对象被找到并按设计显示，而非仅仅不再输出报错。