找物源码导读Cocos Creator 3.8 · assets/scripts
0%
已读 0 / 424
开始阅读
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。

runtime运行时层

195 个文件·2175 方法·38,561 行

这一层是这款游戏自己的东西:manager 按流程组织(加载、大厅、对局、预加载),system 放各业务系统(货币、体力、签到、排行…)。它会依赖框架层,反过来框架层不依赖它。

进入 runtime →195 个文件

阅读指南

三条经验,少走弯路

怎么读

  1. 先从右侧「目录导读」看这一层负责什么,再扫一遍方法列表。
  2. 读代码时点行号左侧,右侧会定位到对应讲解。
  3. 遇到方法卡片上的「调用点」,点开看真实调用上下文。

快捷键

CtrlK全局搜索
CtrlF文件内查找
[]上一个 / 下一个文件
Ctrl+调整代码字号
?快捷键面板
点击行号复制具体行的链接

数据是怎么来的

站点数据由 Python 脚本静态解析 TypeScript 源码生成,随仓库一起提交。 改完游戏源码后依次运行:

python reader_data.py
python build_site.py
npm run build

找物源码导读Cocos Creator 3.8 · assets/scripts私有项目内部使用