【工具分享】Cocos Creator 资源查询与定位工具

大家好,分享一个正在开发中的 Cocos Creator 扩展:资源查询助手。

它主要用于帮助开发者在项目资源较多时,快速查询、筛选和定位资源,减少在资源管理器中反复查找的时间。

说明:当前扩展仍处于开发阶段。
目前主要支持 Cocos Creator 2.x,Cocos Creator 3.x 暂未支持。由于还在持续开发和适配中,部分功能可能存在兼容性问题或运行异常,建议先在测试项目中试用,重要项目使用前请做好备份。

为什么开发这个扩展

在项目规模变大之后,资源查找经常会变成一件比较耗时的事情:

  • 资源数量越来越多,仅靠资源管理器目录层级很难快速定位。

  • 只知道资源名称、UUID 或大概位置时,往往需要反复切换文件夹和搜索。

  • 想查找引用关系时,需要手动打开多个 Prefab、Scene 或 Material 逐个确认。

  • 想找出挂载了某个组件的 Prefab,通常需要逐个打开 Prefab 检查。

  • Prefab 内部节点较多或存在重名节点时,手动定位过程比较繁琐。

  • 查询条件比较复杂时,单次搜索结果过多,还需要继续人工筛选。

这个扩展的初衷,就是补充 Cocos Creator 自带资源管理器在复杂检索、关系查询和节点定位方面的不足:把重复的资源查找和定位工作集中到一个工具中完成,从人工翻目录变成按条件检索,从逐个打开检查变成批量筛选结果。开发者可以先按名称、类型、UUID 或路径筛选资源,再按引用、节点或组件等条件继续缩小范围,最后直接定位到资源或 Prefab 节点,减少中大型项目中的重复操作和排查成本。

主要功能

  • 按资源名称查询

  • 按资源类型查询

  • 按 UUID 查询

  • 按文件夹路径查询

  • 查询资源引用关系

  • 查询 Prefab 内部节点

  • 按节点名称查询

  • 按组件类型查询

  • 在资源管理器中定位资源

  • 定位 Prefab 内具体节点

  • 支持多个查询条件按顺序组合筛选

  • 支持查询结果分页和多标签页

  • 支持停止耗时较长的查询

当前支持版本

目前主要支持:

Cocos Creator 2.4.x

Cocos Creator 3.x 版本目前暂未支持,如果大家也有这方面的需求再考虑适配。

扩展目前仍处于开发和测试阶段,操作系统和项目资源类型可能存在兼容差异。如果遇到问题,欢迎提供具体版本、系统环境和复现步骤,方便后续排查和改进。

适合这些场景

  • 项目资源数量较多,资源管理器中不容易快速找到目标资源。

  • 只记得资源名称、UUID 或所在目录。

  • 想查找哪些 Prefab 挂载了某个组件。

  • 想在 Prefab 中定位特定名称的节点。

  • 想查询某个资源被哪些 Prefab、Scene 或 Material 引用。

  • 需要根据多个条件逐步缩小资源范围。

使用方式

安装扩展后,在 Cocos Creator 菜单中打开:

资源查询助手

打开后可以添加查询条件,并按照顺序执行组合查询。

例如:

类型:预制体

节点名:Player

组件:某个自定义组件

即可筛选出包含指定节点和组件的 Prefab,并支持直接定位到对应节点。

后续计划

后续会结合公司内部项目的实际使用经验,逐步把扩展从“资源查询”完善为更完整的项目资源分析与辅助工具。以下是目前规划中的方向,具体开发顺序会根据试用反馈进行调整:

这些方向并不是单纯的设想,相关能力已经在公司内部项目中完成验证,并结合实际项目使用场景进行了测试。目前正在根据通用性、稳定性和对外发布要求继续整理,逐步开放到公共版本中。

  • 资源依赖与引用分析:进一步完善资源引用关系查询,帮助查找资源依赖、反向引用和可能未被使用的资源。

  • Prefab 与场景检查:围绕 Prefab、Scene、节点和组件,增加更方便的结构检查、条件筛选和问题定位能力。

  • 节点属性和值比较:支持按节点属性进行筛选,并对属性值进行比较,例如查找满足指定数值、布尔值或文本值的节点。

  • 批量操作与自动化辅助:在确保安全和可回滚的前提下,增加批量新增节点、组件,删除节点、组件、资源,修改属性值。

以上功能属于公共版本的后续开放计划,相关能力已在公司内部项目中验证成功;当前公开版本主要聚焦于资源查询、引用查询、Prefab 节点和组件查询,以及资源和节点定位。

反馈与建议

如果大家在使用过程中遇到问题,欢迎反馈:

  • Cocos Creator 具体版本。

  • 操作系统和系统版本。

  • 查询条件组合。

  • 遇到的问题或错误信息。

  • 希望增加的查询类型或功能。

特别欢迎 Cocos Creator 2.x 用户试用并提供反馈,也欢迎大家提出 3.x 版本适配需求。

欢迎大家免费试用,也欢迎提出建议和反馈。

下载地址:asset-manage.zip (295.8 KB)

1赞

可以参考下我这个UUID 引用定位查询工具哈

1赞