Unity3D 工程代码阅读方法 - 直捣黄龙篇
从工具准备到代码深读，系统化解析 Unity 工程结构的完整方法论，助你快速理解陌生项目架构。
一、工具准备
1.1 必备工具
| 工具 |
用途 |
推荐版本 |
| Unity Editor |
打开项目，查看资源 |
最新 LTS 版本 |
| Rider |
C# 代码阅读和调试 |
JetBrains Rider |
| VSCode |
轻量级代码查看 |
最新版 |
| Visual Studio |
类图生成 (仅 Windows) |
2019+ |
1.2 开发环境建议
1
2
3
4
5
6
7
8
9
10
| 环境配置建议:
┌─────────────────────────────────────────────────────────┐
│ │
│ 操作系统: Windows (推荐) │
│ 原因: │
│ • Visual Studio 类图功能仅 Windows 可用 │
│ • 更好的工具链支持 │
│ • ADB 等 Android 工具兼容性更好 │
│ │
└─────────────────────────────────────────────────────────┘
|
二、项目初识
2.1 Assets 目录结构
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
| 标准 Unity 项目结构:
┌─────────────────────────────────────────────────────────┐
│ Assets/ │
│ ├── 📁 Scripts/ # C# 脚本 │
│ │ ├── Manager/ # 管理器类 │
│ │ ├── View/ # 视图相关 │
│ │ ├── Model/ # 数据模型 │
│ │ └── Utils/ # 工具类 │
│ ├── 📁 Prefabs/ # 预制体 │
│ ├── 📁 Scenes/ # 场景文件 │
│ ├── 📁 Resources/ # 资源加载 │
│ ├── 📁 Textures/ # 纹理图片 │
│ ├── 📁 Materials/ # 材质资源 │
│ ├── 📁 Animations/ # 动画资源 │
│ ├── 📁 Audio/ # 音频资源 │
│ └── 📁 Plugins/ # 第三方插件 │
│ │
└─────────────────────────────────────────────────────────┘
|
2.2 目录认知要点
| 要点 |
说明 |
| 资源位置 |
明确各类资源的存放路径 |
| 代码结构 |
理解脚本的分层和组织方式 |
| 命名规范 |
识别前缀后缀的功能含义 |
| 第三方库 |
区分自研代码和第三方库 |
三、代码阅读前准备
3.1 生成类图
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
| 类图生成流程:
┌─────────────────────────────────────────────────────────┐
│ │
│ Visual Studio 类图功能: │
│ ┌─────────────────────────────────────┐ │
│ │ 1. 打开 VS → 项目解决方案 │ │
│ │ 2. 视图 → 类图 │ │
│ │ 3. 拖拽 C# 文件到类图 │ │
│ │ 4. 查看继承关系 │ │
│ └─────────────────────────────────────┘ │
│ │
│ 局限: │
│ • ✅ 可见继承关系 │
│ • ❌ 无法识别复杂逻辑 (如 Update 中的循环) │
│ • ❌ 无法识别反射创建类 │
│ • ✅ 对整体认知帮助巨大 │
│ │
└─────────────────────────────────────────────────────────┘
|
3.2 金字塔模型
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
| 认知金字塔模型:
┌─────────────────────────────────────────────────────────┐
│ 👑 主逻辑 │
│ ╱ │ ╲ │
│ ╱ │ ╲ │
│ ╱ │ ╲ │
│ View ────────┐ │ ┌─────── Manager │
│ │ │ │ │
│ ┌─┴────┴────┐ │
│ │ 数据 │ │
│ └───────────┘ │
│ │
│ 多重复合结构分析: │
│ • UML 图 │
│ • 思维导图 │
│ • Blog 文档 │
│ │
└─────────────────────────────────────────────────────────┘
|
四、代码阅读阶段
4.1 工程结构分离
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
| 代码与资源分离:
┌─────────────────────────────────────────────────────────┐
│ │
│ 代码工程结构: │
│ • C# 脚本 │
│ • Lua 脚本 (如有) │
│ • 第三方库集成 │
│ • 自研框架 │
│ │
│ 资源工程结构: │
│ • Prefab │
│ • Scene │
│ • Texture/Material │
│ • Audio/Animation │
│ │
└─────────────────────────────────────────────────────────┘
|
4.2 寻找入口
| 入口类型 |
说明 |
示例 |
| Main 函数 |
启动脚本 |
Bootstrap.cs, Launcher.cs |
| 场景入口 |
首场景或初始化场景 |
BootScene, InitScene |
| UI 入口 |
主界面逻辑 |
MainPanel.cs, Lobby.cs |
| Input 入口 |
输入处理 |
InputManager.cs |
| Manager |
管理器类 |
GameManager.cs |
4.3 代码分组策略
| 分组依据 |
示例前缀/后缀 |
功能标签 |
| 功能模块 |
UI*, Player*, Enemy* |
模块化分组 |
| 架构层级 |
*Manager, *View, *Model |
MVC 分层 |
| 工具类 |
*Util, *Helper, *Tool |
工具函数 |
| 数据类 |
*Data, *Config, *Info |
数据容器 |
五、代码分类阅读
5.1 四种代码类型
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
| 代码分类体系:
┌─────────────────────────────────────────────────────────┐
│ │
│ 类型 1: 纯数据类 (最后阅读) │
│ ┌─────────────────────────────────────┐ │
│ │ • ConfigData │ │
│ │ • PlayerInfo │ │
│ │ • ItemData │ │
│ └─────────────────────────────────────┘ │
│ │
│ 类型 2: 算法/框架类 (第二阅读) │
│ ┌─────────────────────────────────────┐ │
│ │ • ObjectPool │ │
│ │ • LRUCache │ │
│ │ • EventBus │ │
│ │ • Singleton │ │
│ └─────────────────────────────────────┘ │
│ │
│ 类型 3: View 表现类 (第三阅读) │
│ ┌─────────────────────────────────────┐ │
│ │ • MonoBehaviour │ │
│ │ • UI Components │ │
│ │ • Logger/Profiler │ │
│ └─────────────────────────────────────┘ │
│ │
│ 类型 4: 业务逻辑类 (首要阅读) ⭐ │
│ ┌─────────────────────────────────────┐ │
│ │ • 游戏主逻辑 │ │
│ │ • 战斗系统 │ │
│ │ • 任务系统 │ │
│ │ • 关卡流程 │ │
│ └─────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────┘
|
5.2 环形节点金字塔
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
| 节点环形结构:
┌─────────────────────────────────────────────────────────┐
│ │
│ 主逻辑 (中心节点) │
│ ▲ │
│ ╱ ╲ │
│ ╱ ╲ │
│ ╱ 管理 ╲ │
│ ╱ 层 ╲ │
│ ╱ 节点 ╲ │
│ View ◄────┼────► Model │
│ ╲ ╱ │
│ ╲ ╱ │
│ ╲ ╱ │
│ ╲ ╱ │
│ ╲ ╱ │
│ ╳ │
│ (循环闭环) │
│ │
└─────────────────────────────────────────────────────────┘
|
六、代码进阶阅读
6.1 六字真言 (创销增删改查)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
| 代码分析六道轮回:
┌─────────────────────────────────────────────────────────┐
│ │
│ 每个类都是对某个"主角"的操作: │
│ │
│ ┌────────┐ ┌────────┐ ┌────────┐ │
│ │ 创建 │ ──→ │ 销毁 │ ──→ │ 增加 │ │
│ └────────┘ └────────┘ └────────┘ │
│ ▲ │ │ │
│ │ ▼ │ │
│ ┌────────┐ ┌────────┐ ┌────────┐ │
│ │ 修改 │ ◄────│ 删除 │ ◄────│ 查找 │ │
│ └────────┘ └────────┘ └────────┘ │
│ │
│ 分析每一段代码: │
│ • 这段代码是哪个操作？ │
│ • 对应哪个主角变量？ │
│ • 在哪个环节被调用？ │
│ │
└─────────────────────────────────────────────────────────┘
|
6.2 类的主角分析法
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
|
public class ObjectPool
{
private Queue<object> pool = new Queue<object>();
public object Get()
{
if (pool.Count > 0)
return pool.Dequeue();
return CreateNew();
}
public void Return(object obj)
{
pool.Enqueue(obj);
}
public void Clear()
{
pool.Clear();
}
}
|
6.3 断点阅读法
| 方法 |
适用场景 |
技巧 |
| 断点法 |
主体逻辑追踪 |
在入口打断点，逐步执行 |
| Log 法 |
复杂逻辑分析 |
记录变量变化和调用时机 |
| 结合法 |
综合分析 |
两种方法配合使用 |
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
| 断点阅读流程:
┌─────────────────────────────────────────────────────────┐
│ │
│ 1. 在主体逻辑入口打断点 │
│ 2. F10 单步执行 │
│ 3. 观察调用栈和变量变化 │
│ 4. 记录关键节点的执行流程 │
│ 5. 形成流程图或思维导图 │
│ │
│ 注意: │
│ • 每次阅读 1-2 小时 │
│ • 不可过久 (精力不足) │
│ • 不可过短 (流于表面) │
│ • 持续性间歇阅读 │
│ │
└─────────────────────────────────────────────────────────┘
|
6.4 复杂逻辑处理
| 问题 |
解决方案 |
| 找不到主体逻辑 |
查找主循环 (Update/协程) |
| 断点效果不明显 |
使用 Log 法记录变量 |
| 逻辑分散在多处 |
分组标记，追踪数据流 |
| 背景知识不足 |
先补充概念，再回来看 |
七、常见入口点
7.1 入口优先级
| 优先级 |
入口类型 |
示例 |
| ⭐⭐⭐⭐⭐ |
Main/Bootstrap |
Bootstrap.cs, App.cs |
| ⭐⭐⭐⭐ |
场景入口 |
InitScene.unity |
| ⭐⭐⭐ |
UI 入口 |
MainMenu.cs, Lobby.cs |
| ⭐⭐ |
Input 入口 |
InputManager.cs |
| ⭐ |
Manager |
GameManager.cs |
7.2 主循环识别
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
|
public class GameManager : MonoBehaviour
{
void Update()
{
switch (currentState)
{
case GameState.Idle:
UpdateIdle();
break;
case GameState.Fighting:
UpdateFighting();
break;
}
}
void LateUpdate()
{
}
}
|
八、代码阅读后总结
8.1 总结产出
| 产出形式 |
内容 |
| 模块文档 |
各模块功能说明 |
| 架构图 |
UML 类图、时序图 |
| 思维导图 |
系统结构梳理 |
| 流程图 |
关键业务流程 |
| 网络流程 |
协议交互时序 |
8.2 分享与验证
1
2
3
4
5
6
7
8
9
10
11
12
13
14
| 知识分享流程:
┌─────────────────────────────────────────────────────────┐
│ │
│ 1. 编写文档/思维导图 │
│ ↓ │
│ 2. 团队分享/Peer Review │
│ ↓ │
│ 3. 收集反馈，修正理解 │
│ ↓ │
│ 4. 复写/复习/修改 1-3 遍 │
│ ↓ │
│ 5. 成为项目知识资产 │
│ │
└─────────────────────────────────────────────────────────┘
|
九、检查清单
9.1 准备阶段
9.2 阅读阶段
9.3 总结阶段
转载请注明来源，欢迎对文章中的引用来源进行考证，欢迎指出任何有错误或不够清晰的表达。可以在下面评论区评论，也可以邮件至 1487842110@qq.com
