【插件分享】cc_table_tool —— Cocos Creator 表格配置工具

大家好,这里分享一个我近期整理并开源的 Cocos Creator 配置表工具插件

:point_right: cc_table_tool
GitHub:https://github.com/zpqq132555/cc_table_tool

上一篇我分享了跨版本插件系统框架:

这次这个插件,可以理解为 基于那套插件体系的一个实际应用项目 ,主要用于探索和沉淀「配置表工具」这条方向。

一、这个插件目前做什么?

:warning: 先说清楚当前阶段能力

  • :white_check_mark: 目前只兼容 JSON 导入配置
  • :warning: 桌面应用(独立工具)还未完善
  • 插件仍处于持续迭代中

当前核心目标

cc_table_tool 主要聚焦在:

  • JSON 作为配置源
  • Cocos Creator 编辑器侧 管理和处理配置
  • 为后续表格化(Excel / CSV)做结构准备

它更偏向一个 配置工具原型 + 插件工程模板 ,而不是最终形态的一站式表格工具。

二、为什么先从 JSON 开始?

主要是出于这几个考虑:

  • JSON 是 Creator 项目中 最稳定、最直接 的数据形态
  • 可以先把 插件结构、数据流、扩展方式 跑通
  • 避免一开始就被 Excel 解析、格式兼容拖慢节奏

等整体流程稳定后,再逐步引入:

  • Excel
  • 自动转换
  • 校验规则扩展

三、插件的定位

这个项目目前更适合:

  • 想研究 Cocos Creator 插件结构 的同学
  • 想做 配置工具 / 编辑器工具链 的开发者
  • 希望在插件里统一管理配置数据的项目

如果你期待的是「完整可商用的表格工具」,那它 现在还不是
但如果你想要一个 清晰、可扩展的起点 ,它是合适的。

四、与上一篇插件系统的关系

简单说就是:

  • cc_extensions_tools_universal
    :point_right: 插件通用基础框架(跨版本思路)
  • cc_table_tool
    :point_right: 基于该框架的 配置工具实践项目

这个仓库本身,也可以当作一个 插件实战示例工程 来参考。

五、后续计划(非承诺)

后面有时间的话,可能会逐步补充:

  • JSON → 表格结构抽象
  • Excel / CSV 支持
  • 桌面工具形态完善
  • 更完整的使用示例

主要还是按 实际需求驱动 来推进。

六、结语

这次更多是一次 阶段性分享 ,把当前能用、能跑、结构清晰的部分先开源出来,欢迎大家:

  • 提建议
  • 指方向
  • 或一起交流配置工具的设计思路

:pushpin: GitHub:
https://github.com/zpqq132555/cc_table_tool

如果后续功能完善了,也会再来论坛更新进展 :wave:

:point_right:最后文档生成感谢(包括本主题):ChatGPT

6赞

论坛应该多来这些纯粹的分享 :+1:

火钳刘明。

马克马克 :grinning:

[1.0.1] - 2026-02-13

新增 (Added)

  • 操作日志功能:在 Cocos 模式下自动记录数据表操作日志
    • 日志文件:table_tool_operations.log(数据源同目录)
    • 保留最近 200 条记录
    • 记录内容:新建表、删除表、修改表结构、导出表、导入表等

优化 (Changed)

  • 智能 Interface 生成:导出 TypeScript 接口文件时比较内容
    • 仅当接口定义实际发生变化时才更新文件
    • 避免因时间戳变化导致不必要的 Git 提交
    • 应用于单表导出和批量导出

修复 (Fixed)

  • 删除表时清理导出文件:删除数据表时自动删除对应的 JSON 和 TS 文件
    • 同步删除:jsonDir/exportPath/tableKey.json
    • 同步删除:tsDir/exportPath/ITableKey.ts
    • 自动刷新 Cocos 资源数据库
  • 部分BUG修复

其实我的疑问是,为什么数据要导入到 Vue 中进行编辑?直接在 Excel 中编辑有什么问题?
不应该在 Vue 中编辑数据啊,而应该是 Excel -> 标准化数据结构 JSON -> 各个地方都能用(比如说 MySQL)。

编辑数据的地方应该是: Excel

说白了,策划一手的 Excel 技能,直接被你一个工具干到 0,策划肯定不用啊。

个人认为你的方向错了,建议搞一个比 Luban 好用的配置解析工具…

见过策划地狱级表嵌套,不按标准修改数据,或者无意间误改数据的吗?我见过!
经常策划改完数据就来找说 游戏运行不起来了、运行效果未按预期…各种意外骚操作
开了十几个表找到最后发现某个数据预期是number结果因为多了一个字符被解析成默认值。
老项目Excel横表头竖表头不一致…光Excel转json手上就好几套转表工具。
这个项目的初衷:
1.AI练手,想试试能不能实现零代码制作完整的功能。
2.将想试试之前整理的v2、v3通用插件的可行性和一些没考虑到的问题通过具体功能来验证修改。
3.程序可以不打开Excel,通过游戏引擎就可以直观的看到数据,并修改错误数据。而且可以动态的自动生成对应的数据表的表头接口方便项目直接使用
讲白了还是练手。公司大多数都是Unity项目。有相对成熟的配表工具,跟目前这个项目的初衷和设计是一样的,可以说是功能的迁移。后期也会完善策划使用Excel配置数据然后双向自动同步数据到这个工具。这些功能Unity上的表工具都是有的,只不过还没弄到那块。还有就是想把公司多套不同的转表工具统一一下。现在手上几个维护项目一个项目一个打表工具真的是日了狗了

配表加数据验证模块就好了。Excel 编辑好处肯定很多,尤其是它的操作:筛选、排序、过滤,批量修改、VBA编程、各种公式关联,你开发一个类似编辑器的时间成本是超高的。
就算你搞定了那些,后面没人用,那才最尴尬。至于技术验证?理论通过了就好,技术也没什么高难度的技术含量,纯粹堆时间。

最后,想做就继续做吧,万一搞成另一个Excel 呢