示例 Unity 项目结构(Playable Game Template)

一、整体设计原则(先说清楚,博客加分)

这套结构遵循 4 个原则:

  1. 按职责分层,而不是按类型乱放

  2. 脚本 = 行为,而不是"万能控制器"

  3. 数据与逻辑分离

  4. 允许项目在小规模下保持简单


二、推荐目录结构(Assets)

复制代码
Assets/
├── Scenes/
│   ├── Bootstrap.unity
│   └── Game.unity
│
├── Scripts/
│   ├── Core/
│   │   ├── GameManager.cs
│   │   └── GameState.cs
│   │
│   ├── Player/
│   │   ├── PlayerMove.cs
│   │   ├── PlayerJump.cs
│   │   └── PlayerHealth.cs
│   │
│   ├── Systems/
│   │   ├── InputSystem/
│   │   │   └── PlayerInput.cs
│   │   ├── AudioSystem/
│   │   │   └── AudioManager.cs
│   │   └── UISystem/
│   │       └── UIManager.cs
│   │
│   ├── Gameplay/
│   │   ├── Goal.cs
│   │   └── DeadZone.cs
│   │
│   └── Utils/
│       └── Timer.cs
│
├── ScriptableObjects/
│   ├── PlayerConfig.asset
│   └── LevelConfig.asset
│
├── Prefabs/
│   ├── Player.prefab
│   └── UI.prefab
│
├── Art/
│   ├── Sprites/
│   └── Animations/
│
├── Audio/
│   ├── BGM/
│   └── SFX/
│
└── Settings/
    └── InputActions.inputactions

三、各目录的「工程意义」(博客重点)

1️⃣ Scenes ------ 游戏流程层

复制代码
Scenes/
 ├── Bootstrap.unity
 └── Game.unity
  • Bootstrap:初始化全局系统(音频、配置)

  • Game:真正的游戏内容

📌 工程思想:

把"启动逻辑"和"玩法逻辑"分开

后期加菜单 / 多关卡会非常舒服


2️⃣ Scripts/Core ------ 游戏生命周期控制

复制代码
Scripts/Core/
 ├── GameManager.cs
 └── GameState.cs
  • GameManager:控制流程

  • GameState:枚举状态

    public enum GameState
    {
    Ready,
    Playing,
    Win,
    Lose
    }

📌 好处:

  • 不用到处写 bool isGameOver

  • 博客里很好解释「状态驱动」


3️⃣ Scripts/Player ------ 行为拆分示例

复制代码
Player/
 ├── PlayerMove.cs
 ├── PlayerJump.cs
 └── PlayerHealth.cs

不要这样做:

复制代码
PlayerController.cs(1000 行)

📌 博客可强调:

Unity 鼓励用 组合,而不是继承


4️⃣ Scripts/Systems ------ 可复用系统层

复制代码
Systems/
 ├── InputSystem/
 ├── AudioSystem/
 └── UISystem/

这些系统特点:

  • 不关心具体关卡

  • 不绑定具体角色

  • 可以跨 Scene 存活

例如:

  • AudioManager 使用 DontDestroyOnLoad

  • UIManager 管界面切换


5️⃣ Scripts/Gameplay ------ 关卡内规则

复制代码
Gameplay/
 ├── Goal.cs
 └── DeadZone.cs

职责:

  • 胜利条件

  • 失败触发

  • 与 GameManager 通信

📌 关键点:

Gameplay 只描述规则,不控制流程


6️⃣ ScriptableObjects ------ 数据驱动核心

复制代码
ScriptableObjects/
 ├── PlayerConfig.asset
 └── LevelConfig.asset

用途:

  • 移动速度

  • 跳跃高度

  • 关卡参数

📌 博客亮点:

把「调参」从代码中解放出来


7️⃣ Prefabs ------ 组合结果

复制代码
复制代码
Prefabs/
 ├── Player.prefab
 └── UI.prefab
  • Player.prefab = Move + Jump + Health

  • UI.prefab = Canvas + UIManager

📌 Prefab 是组合的最终形态


四、典型对象关系图(文字版)

复制代码
GameManager
 ├── 控制 GameState
 ├── 接收 Goal / DeadZone 事件
 └── 通知 UIManager 切换界面

Player
 ├── PlayerMove
 ├── PlayerJump
 └── PlayerHealth

五、这套结构适合哪些项目?

✅ Unity 新手练手

✅ 技术博客示例

✅ 课程 / 毕设

✅ 独立游戏原型

❌ 超大型 RPG(需要更复杂架构)


六、博客写作建议(你可以直接用)

在博客中可以这样总结这一节:

这套项目结构并不是"唯一正确",

但它刻意避免了早期 Unity 项目中常见的混乱问题:

  • 脚本职责不清

  • 逻辑高度耦合

  • 后期难以扩展

对于一个「可以玩的游戏原型」,
清晰 > 完美架构。

相关推荐
流浪打工人16 小时前
Unity3d TimeLine中audio track的使用
unity
淡海水18 小时前
02-07-原理篇-GC暂停时间的本质
开发语言·unity·c#·gc·暂停时间
WarPigs18 小时前
UI路径配置SO>字典json工作流
ui·unity
淡海水1 天前
02-06-原理篇-增量式GC与并发GC
算法·unity·c#·并发·gc·增量
阿松爱学习1 天前
【Unity开发】Aspose.PDF的使用
unity·pdf·c#
淡海水2 天前
02-04-原理篇-GC Roots与对象图遍历
算法·unity·c#·图·gc·遍历·roots
辻弋2016 天前
五年前的旅行视频糊成马赛克?Video2X用Real-ESRGAN逐帧重建细节,但只支持Windows、集显用户建议直接放弃
服务器·数据库·windows·游戏引擎·电脑
Martina_03216 天前
AI生成3D场景导入 Unity/Unreal 后,NPC 总串层?用6步检查导航高度与跨层连接
人工智能·游戏·数学建模·3d·unity·自然语言处理·aigc
小贺儿开发6 天前
Unity 局域网遥控幻灯片展示工具 3.0
科技·http·unity·工具·ppt·通信·网页
WarPigs8 天前
Unity对象不应该使用null传播的问题
unity