命名规范
| 类型 | 命名规范 | 示例 |
|---|---|---|
| 文件与文件夹 | snake_case(蛇形) | player_controller.gd,assets/ |
| 类名 / 脚本名 | PascalCase(大驼峰) | PlayerController,YAMLParser |
| 场景节点名 | PascalCase(大驼峰) | HitBox,Camera3D,Player |
| 函数 / 方法 | snake_case(蛇形) | func load_level(): |
| 变量 / 信号 | snake_case(蛇形) | var player_health,signal door_opened |
| 常量 / 枚举成员 | CONSTANT_CASE(全大写) | const MAX_SPEED = 200 |
文件夹结构。
这套结构采用了“按功能模块分类”的逻辑，非常适合中大型项目的长期维护：
res:// (项目根目录) ├── addons/ # 第三方插件（从资产商店下载的插件放这里） ├── assets/ # 纯美术与音频资源（不参与逻辑，只负责存放素材） │ ├── audio/ │ │ ├── music/ # 背景音乐 │ │ └── sfx/ # 音效 │ ├── fonts/ # 字体文件 (.ttf, .otf) │ ├── images/ # 通用图片（如Logo、背景图） │ ├── sprites/ # 精灵图/贴图 │ ├── textures/ # 3D纹理或程序化材质贴图 │ └── models/ # 3D模型文件 (.glb, .obj) ├── scenes/ # 所有的场景文件 (.tscn) │ ├── actors/ # 游戏中的动态实体 │ │ ├── player/ # 玩家相关（如 player.tscn, player.gd） │ │ ├── enemies/ # 敌人相关 │ │ └── npcs/ # NPC相关 │ ├── levels/ # 关卡与地图场景 │ │ ├── world_map.tscn │ │ └── level_01.tscn │ ├── ui/ # UI界面场景 │ │ ├── main_menu.tscn │ │ ├── game_hud.tscn │ │ └── pause_panel.tscn │ └── systems/ # 全局系统场景（如 autoload 的单例场景） ├── scripts/ # 独立的 GDScript 脚本文件 (.gd) │ ├── globals/ # 全局单例脚本（非场景类，如 global_data.gd） │ ├── components/ # 可复用的组件化脚本（如 health_component.gd） │ ├── utils/ # 纯工具类、算法类脚本 │ └── resources/ # 自定义 Resource 资源的配套脚本 ├── resources/ # 游戏数据资源 (.tres, .res) │ ├── items/ # 物品数据（如 sword.tres, potion.tres） │ ├── characters/ # 角色属性配置数据 │ └── levels/ # 关卡专属的配置数据 └── docs/ # 项目开发文档（Godot导出时会自动忽略此文件夹） ├── design.md # 核心设计草案 └── todo.md # 开发待办清单结构设计核心思路
assets/与scenes/彻底分离assets/文件夹只负责存放最原始的素材（图片、声音、模型），而scenes/负责将这些素材组装成带有逻辑的游戏对象。这样做的好处是，当你的项目变大时，找一张图和找一个游戏场景不会混在一起。scripts/独立存放
虽然 Godot 允许把.gd脚本和.tscn场景放在同一个文件夹里，但对于稍微复杂一点的项目，将纯代码脚本抽离到scripts/目录下，会让你的版本控制（Git）提交记录更加清晰，也方便复用代码。充分利用
resources/管理数据
Godot 强大的自定义资源（Custom Resources）系统非常适合做数值策划。将物品的属性、敌人的血量等数据剥离出来放在resources/里，以后你想调整数值平衡时，完全不需要去碰复杂的代码逻辑。善用
docs/文件夹
在根目录建一个docs/用来放你的设计草稿、待办事项或者 AI 对话生成的需求文档。Godot 在打包导出游戏时，默认只会打包引擎识别的资源文件，这些.md或.txt文档不会被塞进最终的游戏包里，所以你可以放心地把项目笔记存在这里。
