Cocos Creator 3.8 · 源码导读
把 assets/scripts 读成一张地图
按真实目录树逐层深入:左边是目录,中间是源码,右边是逐行讲解与方法说明。 每个方法都能点开「调用点」,看到它在哪个文件的哪个方法里被调用、完整的上下文, 以及这次调用在做什么。
424 个源码文件4,259 个方法78,547 行代码逐行注释 · 调用链 · 关系图
424源码文件assets/scripts 下全部 TypeScript
4,259方法 / 函数每个都有签名、参数与返回值说明
78,547行代码逐行注释与代码行一一对应
424人工通读文件其余为规则自动推断,页面内有标记
按目录分组
从职责清晰的目录开始读,比从头硬啃轻松得多bridge桥接层
22 个文件·53 方法·1,995 行
bridge 是业务代码与 framework 之间的静态转接层。每个子目录对应一种框架能力(流程、场景、UI、存档、事件、资源、SDK、服务器等),业务侧通过桥调用,不直接 import Manager。
进入 bridge →22 个文件
framework框架层
207 个文件·2031 方法·37,991 行
与具体玩法无关、可以跨项目复用的能力都在这一层:core 是基础设施,module 是通用功能模块,plugin 是平台插件。它只依赖引擎,不依赖 runtime。
进入 framework →207 个文件
runtime运行时层
195 个文件·2175 方法·38,561 行
这一层是这款游戏自己的东西:manager 按流程组织(加载、大厅、对局、预加载),system 放各业务系统(货币、体力、签到、排行…)。它会依赖框架层,反过来框架层不依赖它。
进入 runtime →195 个文件
阅读指南
三条经验,少走弯路怎么读
- 先从右侧「目录导读」看这一层负责什么,再扫一遍方法列表。
- 读代码时点行号左侧,右侧会定位到对应讲解。
- 遇到方法卡片上的「调用点」,点开看真实调用上下文。
快捷键
CtrlK全局搜索
CtrlF文件内查找
[]上一个 / 下一个文件
Ctrl+调整代码字号
?快捷键面板
点击行号复制具体行的链接
数据是怎么来的
站点数据由 Python 脚本静态解析 TypeScript 源码生成,随仓库一起提交。 改完游戏源码后依次运行:
python reader_data.pypython build_site.pynpm run build