【1】Coco2d creator资源管理注意事项 - meta 文件

今天咱们来唠唠 Cocos Creator 里那个让人又爱又恨的 meta 文件！这玩意儿就像资源界的身份证，要是搞丢了，你的项目分分钟上演 "消失的她" 大戏！

meta 文件的作用

先来看下场景中的 meta 文件长什么样子：

json 复制代码

{  
  "ver": "1.0.0",  // 版本
  "uuid": "911560ae-98b2-4f4f-862f-36b7499f7ce3", // 全局唯一 id
  "asyncLoadAssets": false,  // 异步加载
  "autoReleaseAssets": false,  // 自动释放资源
  "subMetas": {}  // 子元数据
}

预制件的 meta 文件与场景是一样的。我们再来看一下 png 图片的 meta 文件：

json 复制代码

{  
   "ver": "1.0.0",
   "uuid": "19110ebf-4dda-4c90-99d7-34b2aef4d048",
   "type": "sprite",
   "wrapMode": "clamp",
   "filterMode": "bilinear",
   "subMetas": {
       "img_circular": {
       "ver": "1.0.3",
       "uuid": "a2d1f885-6c18-4f67-9ad6-97b35f1fcfcf",
       "rawTextureUuid": "19110ebf-4dda-4c90-99d7-34b2aef4d048",
       "trimType": "auto",
       "trimThreshold": 1,
       "rotated": false,
       "offsetX": 0,
       "offsetY": 0,
       "trimX": 0,
       "trimY": 0,
       "width": 100,
       "height": 100,
       "rawWidth": 100,
       "rawHeight": 100,
       "borderTop": 0,
       "borderBottom": 0,
       "borderLeft": 0,
       "borderRight": 0,
       "subMetas": {}
    }
  }
}

png 图片的 meta 文件信息比较多，除了基本的 ver 和 uuid 外，还记录了图片的宽高、偏移、九宫格等数据。上面这么多信息，我们这里只关心一个：UUID。就像你在游戏里的 ID，改名字换头像都不怕，只要 ID 不变，系统永远认得你～"

UUID: 通用唯一标识符（Universally Unique Identifier）

UUID 是 Creator 用来管理游戏资源的。它会为每个文件分配一个唯一的 id，图集会生成多个。由此可以了解在 Creator 引擎中，识别一个文件不是简单地通过 路径 + 文件名 定位，而是通过 UUID 来引用文件。因此可以在编辑器资源管理中，随意删除、移动文件。

meta 文件更新时机

Creator 生成 meta 文件有以下几种情况：

1、打开工程时

打开项目工程时，Creator 会先扫描 assets 目录，如果哪个文件还没有 meta 文件，此时就会生成。

2、更新资源时

更新资源也会引发 meta 文件的更新：

在 资源管理器 中可以对资源进行文件名修改、改变目录、删除文件，添加文件等操作，请参考资源管理器。也可以直接从桌面或操作系统的文件管理器中将文件拖入到 资源管理器 中。

还有一种情况是在操作系统的文件管理器中对 assets 目录中的文件进行增、删、改之后切换到编辑器界面，此时可以看到 资源管理器 刷新的过程。

如果一个文件的 meta 文件不存在，上面两种情况都会触发引擎去生成 meta 文件。

meta 文件出错的几种情况及解决方法

下面我们分析下 meta 文件出错的几种可能情况。

UUID 冲突

UUID 是全局唯一的，产生冲突肯定是有不同的文件的 UUID 相同了，一旦出现这个问题会导致 Cocos Creator 资源管理器目录结构加载不完整。如下图所示，遇到这种情况估计会让你吓出一身冷汗：

从提示中可以看到冲突的 UUID 字符串，然后打开操作系统文件管理或代码编辑器，搜索这个 UUID：

先把编辑器关了，去文件夹里随便删个小本本（就是那个 meta 文件啦），再打开编辑器就能复活了！不过这招有点副作用哦，之前引用这个资源的地方会变成 "资源已跑路"，得重新装修一遍界面或者配置参数，相当于给房子重新贴瓷砖，麻烦得很！

其实最好的办法是用版本管理工具回滚这个 meta 文件，就像用时光机把搞砸的文件救回来。为啥会出现这种祖传 bug 呢？通常有两种情况：

手滑版：在文件夹里移动文件时，本来想剪切粘贴，结果手一抖复制了，连带着 meta 文件也复制了，导致项目里出现两个同名同姓的 "双胞胎"。
欧皇版：多人协作时，别人生成的文件身份证号（UUID）和你电脑里的某个文件撞上了，这种概率比中彩票还低，遇到的话建议去买刮刮乐。

要避免这种情况，记住在编辑器里直接操作文件，就像在游戏里直接打怪升级，别跑到文件夹里瞎折腾。毕竟直接动文件就像拆乐高时不看说明书，容易拼出个四不像！下次手滑前先想想：是编辑器不香了，还是文件夹里有黄金？

UUID 变化

还有一种情况是 UUID 变了，使得旧的 UUID 对应的资源无法找到，这样的话，你曾经编辑的界面将会出现资源、图片丢失，还可能出现组件属性丢失。

如果找不到旧的 UUID 对应的资源，通过 控制台 可以看到 Creator 给出了所在的场景文件名、节点路径、组件、UUID 等非常详细的警告信息。通过警告信息可以快速定位出错的地方。

这种情况又是怎么造成的呢？当有一个人将新资源添加进项目时，忘记切换到编辑器界面使其生成 meta 文件，同时又将这些新增的文件提交到了版本管理中(不包含 meta 文件)。然后，有另一个人去更新了他所提交的资源，同时切换到了编辑器界面进行编辑，这时 Creator 会检查到新资源没有 meta 文件便会立即生成。而当第一个人切换到编辑器的时候也会生成 meta 文件，这样两个人的电脑上为同一个文件，但是生成的 meta 文件中的 UUID 都不相同。

这种情况下，后面进行资源提交或更新的人，肯定也会遇到冲突，如果不明就理就强行解决冲突，就会产生上面所说的问题。下面的时序图就描述了这种错误的工作流程：

因为第一个 A 同学忘记生成 meta 文件并提交，之后其他人都编辑过项目，但每个人生成的 UUID 都不同，这样就会陷入无限的资源出错中，编辑好的东西，一提交更新又出现冲突了。

要解决这个问题注意下面几点：

提交前检查是否有新增文件，有新增文件时，注意是否有 meta 文件，需要一起提交；
拉取文件时，注意是否有新增文件，并且是有 meta 文件成对，如果没有的话，提醒之前提交文件的同学，把 meta 文件一并提交；
提交时，如果发现只有新增的 meta 文件，那这个 meta 文件肯定是自己生成的，需要注意是否使用过这个 meta 文件对应的资源（同名文件）。如果没用过，那请最早提交者把 meta 文件提交了。千万不能将这个 meta 文件提交上去。

注意上面几点基本上就可以杜绝 meta 文件 UUID 变化导致的工程出错了。

小结

【meta 文件の暴走时刻】

🔥 UUID 冲突：

当两个文件突然发现自己身份证号一样，Creator 会直接裂开：

plaintext 复制代码

[Error] UUID冲突！文件管理器加载失败！

（解决办法：闭着眼睛删一个 meta，然后准备好重新配置资源吧～）

⚠️ UUID 消失术：

当你的资源突然玩失踪，控制台会疯狂刷弹幕：

plaintext 复制代码

[Warning] 找不到资源！路径：场景/节点/组件 UUID：19110ebf-4dda-4c90-99d7-34b2aef4d048

（都是因为有人偷偷摸摸复制文件却没带 meta 身份证！）

【防坑指南】

提交前必做 ：
✅ 检查新增文件有没有带 "小尾巴"（meta 文件）
✅ 用编辑器移动文件，别自己手滑复制粘贴
✅ 发现只有 meta 文件，千万别提交！那是你电脑自己瞎几把生成的！
拉取时注意 ：
🚨 看到没有 meta 的新文件，立刻 @同事："兄弟！你漏了身份证！"
多人协作禁忌 ：
❌ 别学鸽子王，提交文件不带 meta
❌ 遇到冲突别硬刚，先搞清楚是谁的锅
❌ 别用 Windows 资源管理器直接改文件名（除非你想体验心跳加速）

【划重点】

meta 文件就像资源的房产证，弄丢了就等着哭吧！记住：

👉 用编辑器操作文件

👉 提交前检查 "文件 + meta" 成对出现

👉 遇到问题先查 UUID，再骂同事（不是）

最后送大家一首打油诗：

"meta 文件不能少，UUID 是个宝

提交之前看两眼，协作才能没烦恼！"