跨平台打包、性能优化、安全加密与工程规范完整教程
作者:豆包,昔莘,筱筱
本部分承接前四部分内容,专为熟悉 Unity C# 的资深开发者打造,全程基于Godot 4.x .NET 稳定版,聚焦商业级项目落地的核心环节:跨平台打包、全维度性能优化、代码与资源安全防护、大型团队工程规范,所有内容均与 Unity 开发体系 1:1 精准对标,覆盖 C# 专属的打包坑、优化点、加密方案,可直接复制保存为 Markdown 文档。前置要求:已完成前四部分的核心体系学习,掌握 Godot C# 开发全流程,项目已完成核心功能开发。
一、跨平台打包发布全流程(对标 Unity Build Settings + Player Settings)
核心前置差异说明

1. 打包通用前置准备(所有平台必做)
1.1 安装正确的.NET 导出模板
- 打开 Godot 编辑器,进入「编辑器 → 管理导出模板」
- 选择与你的编辑器版本完全一致的版本,点击「下载并安装」,必须选择带.NET标识的模板
- 安装完成后,重启编辑器,确认「导出」功能可正常打开
❌ 高频踩坑:使用标准版导出模板、模板与编辑器版本不一致,会导致 C# 代码打包后完全不生效、程序启动崩溃。
1.2 项目基础配置
- 场景与资源配置 进入「项目 → 项目设置 → 通用」,设置项目名称、版本号、图标、启动画面 进入「项目 → 导出 → 资源」,配置打包包含的资源: 自动包含模式推荐选择「仅包括选中的资源 + 依赖项」,避免无用资源被打包进包体 手动添加未被代码直接引用的场景、资源(如动态加载的关卡场景)
- C# 专属核心配置 进入「项目 → 项目设置 → Dotnet」,确认: 目标框架:.NET 6.0/.NET 8.0 LTS(推荐 8.0,跨平台兼容性更好) 发布配置:Release 模式,禁用 Debug 符号(正式打包) 打开项目的.csproj文件,添加 AOT 与裁剪配置(移动端 / WebGL 必加): xml

3.预打包校验
- 所有 C# 代码已完成 Build,无编译错误
- 所有资源路径无中文、无空格,严格统一大小写(跨平台路径大小写敏感)
- 所有 Autoload 节点配置正确,无引用丢失
- 禁用编辑器 Debug 功能,关闭 Gizmos、调试绘制代码
2. 分平台打包完整指南(C# 专属重点标注)
2.1 Windows 平台打包(对标 Unity Windows Standalone 打包)
前置环境要求
- 安装.NET 6.0/8.0 SDK,Windows 10/11 SDK(Visual Studio Installer 中安装)
导出步骤
- 进入「项目 → 导出」,点击「添加…」,选择「Windows Desktop」
- 核心配置项:

- C# 专属配置: 启用「包含.NET 运行时」,避免用户电脑需单独安装.NET 启用「裁剪未使用的代码」,减少包体体积
- 点击「导出项目」,选择导出路径,等待打包完成
高频踩坑与解决方案
- 打包后启动无响应:未使用.NET 导出模板,或 C# 代码有编译错误,重新 Build 代码后重新打包
- 杀毒软件误报:单文件打包易被误报,可关闭单文件打包,或添加数字签名
- 缺少依赖项:启用「包含.NET 运行时」,确保所有依赖项被打包
2.2 Android 平台打包(对标 Unity Android 打包,C# AOT 重点)
前置环境要求
- 安装 JDK 17(必须,Godot 4.x 强制要求)、Android SDK API 34+、NDK r25+
- 进入「编辑器 → 编辑器设置 → 导出 → Android」,配置 JDK、SDK、NDK 路径(对标 Unity 的 External Tools 配置)
- 准备签名文件(.keystore),对标 Unity 的签名配置
导出步骤
- 进入「项目 → 导出」,添加「Android」预设
- 核心配置项:

- 签名配置:
进入「签名」选项卡,配置 Keystore 文件、别名、密码,启用「使用自定义发布签名」
- C# 专属核心配置(必做,否则打包失败 / 运行崩溃):
- 启用「AOT 编译」,Android 平台强制 AOT,对标 Unity 的 IL2CPP
- 禁用「动态代码生成」,AOT 平台不支持 System.Reflection.Emit
- 裁剪模式选择「链接 SDK 和用户程序集」,减少包体体积
- 对无法被裁剪分析器识别的泛型、反射代码,添加rd.xml根描述文件,避免裁剪后运行时报错
- 点击「导出项目」,生成 APK/ABB 文件
高频踩坑与解决方案
- 打包失败:JDK/SDK/NDK 版本不匹配,必须使用 JDK17,NDK r25+
- 安装后启动崩溃:AOT 编译时裁剪了必要代码,添加 rd.xml 保留反射用到的类型
- 无法访问网络:未添加 INTERNET 权限,或启用了「互联网权限」开关
- 包体过大:启用纹理压缩、音频压缩,裁剪未使用的引擎模块
2.3 WebGL 平台打包(对标 Unity WebGL 打包,C# 限制重点)
前置环境要求
- 安装.NET 8.0 SDK,启用 WebAssembly 工作负载(命令行:dotnet workload install wasm-tools)
导出步骤
- 进入「项目 → 导出」,添加「Web」预设
- 核心配置项:

- C# 专属核心限制(必看,否则运行时报错):
- WebGL 平台强制 AOT 编译,不支持:动态代码生成、多线程、反射.Emit、非托管代码调用
- 禁用代码裁剪,或严格配置 rd.xml 保留所有用到的类型
- 异步逻辑必须使用 Godot 的ToSignal,避免原生.NET Task 导致的线程问题
- 点击「导出项目」,生成 Web 静态文件
高频踩坑与解决方案
- 页面加载白屏:内存上限设置过小,或代码裁剪导致类型丢失
- 交互无响应:使用了多线程、动态代码,禁用相关逻辑
- 音频无法播放:浏览器自动播放策略限制,需用户交互后再播放音频
2.4 iOS 平台打包(对标 Unity iOS 打包)
前置环境要求
- MacOS 系统,Xcode 14+,安装对应版本的.NET SDK、iOS 导出模板
- 苹果开发者账号,配置好证书与描述文件
导出步骤
- 进入「项目 → 导出」,添加「iOS」预设
- 核心配置项:

- C# 专属配置:
- 启用「AOT 编译」,iOS 平台强制 AOT,不支持 JIT
- 禁用「动态代码生成」,避免 App Store 审核被拒
- 启用「LLVM 优化」,提升运行性能
- 点击「导出项目」,生成 Xcode 工程
- 打开 Xcode 工程,配置签名、证书,编译打包为 IPA 文件
高频踩坑与解决方案
- Xcode 编译失败:AOT 编译配置错误,或导出模板版本不匹配
- App Store 审核被拒:使用了禁用的私有 API,或动态代码生成逻辑
- 启动崩溃:代码裁剪丢失了必要类型,或反射代码未做 AOT 适配
3. 跨平台打包通用避坑指南
- 【强制规范】所有资源路径、文件名必须使用英文、无空格、统一大小写 Windows 平台路径不区分大小写,但 Linux、Mac、Android、iOS、WebGL 严格区分大小写,统一使用小写 + 下划线命名,避免跨平台资源加载失败。
- 【C# 专属坑】AOT 平台必须提前处理反射与泛型代码 移动端、WebGL、iOS 等 AOT 平台,无法在运行时生成泛型实例、动态代码,所有反射用到的类型、泛型类必须提前在代码中显式声明,或通过 rd.xml 保留,避免运行时NotSupportedException。
- 【高频坑】打包前必须重新 Build C# 代码 代码修改后未 Build 就打包,会导致打包的是旧版本代码,修改不生效,这是 Unity 开发者最容易踩的习惯坑。
- 【包体优化坑】禁用未使用的引擎模块 进入「项目 → 项目设置 → 插件」,禁用未使用的引擎模块(如 XR、VR、视频、网络),可大幅减少包体体积,对标 Unity 的模块裁剪。
- 【权限规范】仅申请必要的平台权限 避免申请不必要的权限,导致应用商店审核被拒、用户反感,仅在需要时动态申请权限。
二、Godot C# 项目全维度性能优化方案(对标 Unity Profiler 性能优化体系)
核心前置说明
Godot 的性能优化逻辑与 Unity 高度一致,核心分为CPU、内存、渲染、包体体积四大维度,同时提供了完整的性能分析工具,Unity 开发者可快速平移优化经验。本部分重点突出 Godot 专属优化点、C# 专属优化坑,以及与 Unity 的优化逻辑差异。
1. 性能分析工具(对标 Unity Profiler + Frame Debugger)

优化核心原则
- 先定位瓶颈,再优化,禁止盲目优化;
- 优先优化占比最高的瓶颈点,80% 的性能问题来自 20% 的代码 / 节点;
- 所有优化必须在 Release 模式、真机上测试,编辑器内的性能数据不代表真机表现。
2. CPU 性能优化
2.1 C# 代码层面优化(与 Unity 通用 + Godot 专属)

2.2 节点与场景优化
- 对象池复用:高频创建销毁的节点(子弹、特效、怪物、UI 格子)必须使用对象池,禁止频繁Instantiate/QueueFree,对标 Unity 的对象池优化,可直接复用第四部分的对象池代码。
- 节点树精简:避免单场景节点数量超过 10000 个,拆分大型场景为多个子场景,按需加载卸载;删除空节点、无用节点,减少场景树遍历开销。
- ProcessMode 合理使用: 暂停菜单、UI 动画使用ProcessModeEnum.Always,不受游戏暂停影响 不可见、未激活的节点设置为ProcessModeEnum.Disabled,完全关闭生命周期回调
- 场景加载优化:大场景必须异步加载,使用加载界面过渡,禁止同步加载阻塞主线程,对标 Unity 的异步场景加载优化。
2.3 物理系统优化
- Jolt 引擎专属优化:3D 项目使用默认 Jolt 引擎,禁用「连续碰撞检测 (CCD)」仅对高速移动的物体启用,减少物理计算开销。
- 碰撞体优化: 静态物体必须使用StaticBody2D/3D,物理引擎会进行静态烘焙,零运行时开销 优先使用简单碰撞形状(盒体、球体、胶囊体),禁止使用高精度网格碰撞体,对标 Unity 的碰撞体优化 碰撞体必须是物理节点的直接子节点,避免嵌套过深导致物理计算开销增加
- 碰撞层级优化:合理设置 Collision Layer/Mask,仅让需要交互的物体之间产生碰撞检测,减少物理引擎的检测次数,对标 Unity 的 Layer Mask 优化。
- 物理步长优化:默认物理帧率为 60Hz,移动端可降低到 30Hz,减少物理计算次数,提升性能。
3. 内存优化
3.1 资源内存优化
- 引用计数管理:Godot 资源原生自带引用计数,不再使用的资源必须解除所有引用(节点、脚本、集合中的引用),调用ResourceLoader.Unload()手动卸载,或通过ResourceLoader.UnloadUnusedResources()批量卸载未使用的资源,对标 Unity 的资源卸载逻辑。
- 资源池化:高频使用的纹理、音频、模型、预制体必须预加载并缓存,禁止频繁加载卸载,减少内存碎片与加载开销。
- 纹理优化: 合理设置纹理尺寸,移动端最大不超过 2048x2048,避免超大纹理 启用 Mipmap,3D 场景、远距离渲染的纹理必须开启,减少显存占用,提升渲染性能 分平台设置纹理压缩格式:

- 音频优化:
- 长音频(BGM、环境音)使用 OGG/MP3 格式,启用「流模式」,无需全部加载到内存
- 短音频(SFX、UI 音效)使用 WAV 格式,启用「预加载」,减少播放延迟
- 复用音频资源,禁止同一段音频创建多个实例,使用对象池管理音频播放器。
3.2 C# 内存优化
- GC 优化: 避免在帧循环中分配堆内存,所有临时变量尽量使用值类型(struct),减少 GC 压力 大对象(超过 85000 字节)禁止频繁创建,避免大对象堆碎片化 手动控制 GC 时机,在场景切换、加载界面时调用GC.Collect(),避免游戏过程中 GC 卡顿
- 内存泄漏防护: 节点销毁前必须解绑所有信号、事件委托,避免循环引用导致节点无法被释放 静态变量、单例中禁止缓存大量临时资源,避免内存持续上涨 非托管资源必须实现IDisposable接口,使用using语句自动释放,对标 Unity 的非托管资源释放逻辑。
4. 渲染性能优化
4.1 2D 渲染优化
- Draw Call 合批优化: 使用相同材质、相同图集的精灵会被自动合批,尽量将同场景的精灵打包到同一图集 连续的相同 Z Index 的节点会被合批,避免 Z Index 频繁交替导致合批中断 禁用节点的「自定义材质」,尽量复用默认材质,减少材质切换导致的 Draw Call 增加
- 可见性裁剪: 超出视口的节点设置Visible = false,禁用渲染,对标 Unity 的视口裁剪 大型 TileMap 启用「可见性裁剪」,仅渲染视口内的瓦片,减少渲染开销
- 特效优化: 粒子特效控制粒子数量,移动端单特效粒子数不超过 100 个 禁用粒子的「光照、阴影、碰撞」,仅保留必要的功能 超出视口的特效直接停止并回收,避免无效渲染。
4.2 3D 渲染优化
- 光源优化: Forward + 渲染器虽支持海量光源,但移动端实时光源数量控制在 4 个以内,优先使用静态光照烘焙 禁用不必要的实时光影,阴影分辨率按需设置,移动端禁用阴影或使用低分辨率阴影
- 模型优化: 启用 LOD 系统,远距离模型使用低面数网格,减少顶点处理开销,对标 Unity 的 LOD Group 静态物体启用「静态烘焙」,合并网格,减少 Draw Call 复用材质与 Shader,相同 Shader 的物体启用 GPU Instancing,实现合批渲染
- 渲染管线优化: 移动端项目使用 Mobile 渲染器,禁用 Forward + 的高级特性,减少 GPU 开销 禁用不必要的后期效果,移动端仅保留必要的 Bloom、色调映射,禁用 SSR、SSAO 等高开销效果 合理设置渲染分辨率,移动端可降低渲染比例,提升帧率。
4.3 UI 渲染优化
- CanvasLayer 分层渲染: 静态 UI、动态 UI、弹窗、悬浮窗分属不同的 CanvasLayer,避免局部 UI 变化导致整个画布重绘,对标 Unity 的 Canvas 分层合批优化
- 控件复用: 列表、背包等滚动 UI 使用循环列表,仅渲染视口内的控件,禁止一次性生成所有格子,对标 Unity 的循环列表优化 禁用不可见的 UI 控件,设置Visible = false + ProcessMode = Disabled,减少渲染与逻辑开销
- 样式优化: 使用 Theme 主题统一管理 UI 样式,复用材质、字体、图标,减少材质切换导致的 Draw Call 增加 禁用控件的「Clip Contents」,除非必要,裁剪会导致合批中断,增加渲染开销。
5. 包体体积优化
- 资源裁剪: 导出时启用「移除未使用的资源」,删除项目中未被引用的资源、废弃场景、测试资源 纹理、音频、模型按需压缩,降低资源体积
- 代码裁剪: 启用.NET 程序集裁剪,移除未使用的代码、类、方法,减少 DLL 体积 禁用未使用的引擎模块、插件,减少引擎核心体积
- 打包优化: 启用 PCK 包压缩,减少资源包体积 大型项目使用 PCK 分包,核心资源打包在主包,关卡资源按需动态下载加载,减少安装包体积 移动端启用 App Bundle(ABB)格式,Google Play / 应用商店会按需分发对应架构的安装包,减少用户下载体积。
三、代码与资源安全加密、反破解方案
核心前置说明
Godot 项目的核心安全风险与 Unity 高度一致:
- C# 编译生成的 DLL 文件易被 ILSpy、dnSpy 等工具反编译,核心逻辑泄露
- PCK 资源包可被官方工具直接解压,纹理、模型、音频、场景资源极易被提取
- 存档数据被玩家修改,破坏游戏平衡
- 内存修改、调试器破解,实现作弊功能 本部分针对以上风险,提供商业级的安全防护方案,重点突出 C# 专属的加密方案,对标 Unity 的代码混淆、资源加密、反破解体系。
1. C# 代码安全防护
1.1 代码混淆(基础防护,必做)
代码混淆是最基础的防护手段,通过重命名类、方法、变量,添加垃圾代码,控制流混淆,让反编译后的代码无法阅读,对标 Unity 的代码混淆方案。
推荐工具与配置
- 首选工具:ConfuserEx 2(免费开源)、Babel Obfuscator(商业级,适配 Godot)
- 混淆配置要点(Godot C# 专属): 禁用「名称混淆」对 Godot 的生命周期方法(_Ready、_Process)、信号委托、导出字段的混淆,否则会导致节点绑定失败、信号无法触发 启用「控制流混淆」、「字符串加密」、「反反编译」、「反调试」功能 对核心业务逻辑(付费验证、战斗计算、存档读写)启用最高级别的混淆 对 Autoload 单例、节点脚本保留类名,避免反射、节点绑定失败
- 集成方式: 在项目的.csproj文件中添加混淆构建步骤,打包时自动执行混淆,无需手动操作 xml
<Target Name="Obfuscate" AfterTargets="AfterBuild" Condition=" '$(Configuration)' == 'Release' ">
<Exec Command="Confuser.CLI.exe 混淆配置文件.crproj -n" />
</Target>
1.2 AOT 编译(进阶防护,移动端 / 主机端必做)
移动端、iOS、主机平台强制使用 AOT 编译,将 C# 代码直接编译为对应平台的原生机器码,打包后不会包含 DLL 文件,从根本上避免反编译,对标 Unity 的 IL2CPP 编译模式,是目前最有效的 C# 代码防护方案。
核心优势
- 无 DLL 文件泄露风险,反编译只能得到汇编代码,无法还原 C# 逻辑
- 运行性能更高,比 JIT 模式快 30% 以上
- 应用商店审核兼容性更好,避免 JIT 代码被拒
1.3 程序集加密(桌面端专属防护)
桌面端默认使用 JIT 模式,会包含 DLL 文件,需对 DLL 进行加密,运行时解密加载,避免 DLL 被直接提取反编译。
实现方案
- 打包后对 C# 程序集进行 AES 加密,替换原有的 DLL 文件
- 实现自定义的.NET 程序集加载器,在程序启动时,将加密的 DLL 解密到内存中,通过Assembly.Load加载,不写入磁盘
- 注意事项:解密逻辑必须写在 Native 层(C++ GDExtension),否则解密逻辑本身会被反编译,失去加密意义。
1.4 核心代码 Native 化(终极防护)
将付费验证、反作弊、核心战斗、存档加密等关键逻辑,使用 C++ 编写为 GDExtension 插件,编译为原生动态库,C# 代码仅调用封装后的接口,对标 Unity 的 Native C++ 插件。
- 优势:原生代码无法被反编译,安全性最高,性能最优
- 适用场景:商业级付费游戏、强反作弊需求的网游、单机游戏
2. 资源包(PCK)加密防护
Godot 的 PCK 资源包默认无加密,可通过GodotPckTool等工具直接解压,提取所有资源,必须开启加密防护。
2.1 内置 PCK 加密(基础防护,必做)
Godot 原生支持 PCK 包 AES-256 加密,无需额外代码,打包时一键开启。
配置步骤
- 进入「项目 → 导出」,选择对应的导出预设
- 进入「选项」选项卡,找到「密钥」设置项
- 输入 32 位的 AES 密钥(自行生成,妥善保管,不可泄露)
- 打包时会自动对 PCK 包进行 AES-256 加密,运行时引擎自动解密加载
⚠️ 注意:密钥会被编译到引擎可执行文件中,需配合可执行文件加密、代码混淆,避免密钥被逆向提取。
2.2 自定义 PCK 加密与分包加载(进阶防护)
对于核心资源(如付费关卡、时装、剧情资源),使用自定义加密方案,打包为独立的 PCK 分包,运行时按需解密加载,避免主包密钥泄露导致所有资源被提取。
实现核心逻辑
代码块
// 加载加密的PCK分包
public bool LoadEncryptedPck(string pckPath)
{
try
{
// 1. 校验PCK文件完整性
if (!FileAccess.FileExists(pckPath))
{
GD.PushError($"PCK文件不存在:{pckPath}");
return false;
}
// 2. 自定义解密逻辑(此处为示例,商业项目需更复杂的加密方案)
byte[] keyBytes = Encoding.UTF8.GetBytes(CustomKey.PadRight(32).Substring(0, 32));
// 3. 加载PCK包,引擎会使用内置密钥解密,自定义加密需在此处预处理
bool loadResult = ProjectSettings.LoadResourcePack(pckPath);
if (loadResult)
{
GD.Print($"PCK分包加载成功:{pckPath}");
}
return loadResult;
}
catch (Exception e)
{
GD.PushError($"PCK分包加载失败:{e.Message}");
return false;
}
}
// 卸载PCK分包
public bool UnloadPck(string pckPath)
{
return ProjectSettings.UnloadResourcePack(pckPath);
}
}
2.3 单资源加密(终极防护)
对核心纹理、模型、场景资源进行单独加密,运行时加载到内存中解密,再创建资源对象,即使 PCK 包被解压,资源也无法被直接打开。
- 适用场景:核心美术资源、付费内容、防二次创作的资源
- 实现方案:纹理、音频文件使用自定义 AES 加密,加载时通过FileAccess读取字节流,解密后通过Image.LoadFromWebp/AudioStreamOggVorbis.LoadFromBuffer等方法创建资源对象。
3. 存档与数据安全防护
承接第四部分的存档加密方案,提供进阶的防篡改、防修改方案:
- 加盐哈希校验:存档数据加密后,生成 MD5/SHA256 哈希值,与存档文件一起存储,加载时先校验哈希值,不一致则说明存档被篡改,直接拒绝加载。
- 多文件备份:自动生成存档备份文件,主存档被篡改时,自动从备份恢复,避免存档丢失。
- 关键数据异或加密:内存中的关键数据(血量、分数、金币)使用异或加密,避免 Cheat Engine 等内存修改工具直接搜索修改,对标 Unity 的内存防修改方案。
- 服务端校验:联网游戏的核心数据必须存储在服务端,本地仅做缓存,每次操作都需服务端校验,从根本上避免数据篡改。
4. 反调试与反破解防护
- 调试器检测:启动时检测是否有调试器附加,检测到则直接退出程序,或触发虚假逻辑,避免代码被动态调试。
- 完整性校验:启动时校验主程序、PCK 包、DLL 文件的 MD5 哈希值,与预设值对比,不一致则说明文件被篡改,直接退出。
- 时间校验:单机游戏校验系统时间,避免玩家修改系统时间实现作弊(如签到、冷却时间)。
- 反内存修改:关键数据双份存储,实时校验两份数据是否一致,不一致则触发作弊处理,避免内存修改。
四、大型项目工程规范与团队协作方案
核心前置说明
Unity 开发者转 Godot,最容易出现的问题就是用 Unity 的工程规范套 Godot,导致项目后期维护困难、团队协作冲突频繁。本部分针对 Godot 的节点树架构、C# 开发模式,提供商业级大型项目的工程规范,适配团队协作,对标 Unity 的工程规范体系。
1. 项目目录结构规范(大型项目通用,对标 Unity Assets 目录)
统一的目录结构是团队协作的基础,所有资源、代码必须按功能模块分类,禁止零散存放,目录名统一使用小写 + 下划线,无中文、无空格,跨平台兼容。
目录规范核心原则

- 数字前缀排序:核心模块使用数字前缀,确保启动模块、核心代码排在最前面,避免混乱
- 按功能模块拆分:禁止按资源类型拆分到根目录(如根目录建 Textures 文件夹),必须按功能模块 + 资源类型二级拆分
- 预制体与场景分离:可复用的预制体统一放在02_Scenes/Prefabs/目录下,禁止和关卡场景混放
- 第三方资源隔离:所有第三方插件、库必须放在01_Scripts/3rdParty/目录下,禁止和项目代码混放,方便版本更新与维护。
2. C# 代码规范(Godot 专属,适配节点树架构)
基于微软 C# 官方规范,结合 Godot 引擎的特点,制定统一的代码规范,确保团队代码风格一致,可维护性强。
2.1 命名规范

2.2 脚本结构规范
每个脚本必须遵循统一的结构顺序,提升可读性与维护性:
代码块
// 1. 命名空间引用
using Godot;
using System;
using System.Collections.Generic;
// 2. 命名空间(大型项目必须使用命名空间,避免类名冲突)
namespace YourProjectName.Gameplay
{
// 3. 类声明,必须加[GlobalClass]让编辑器可见,必须为partial类
[GlobalClass]
public partial class PlayerController : CharacterBody2D
{
#region 4. 信号定义(统一放在最前面)
[Signal] public delegate void HealthChangedEventHandler(int current, int max);
[Signal] public delegate void PlayerDiedEventHandler();
#endregion
#region 5. 导出字段(编辑器可见)
[Export] public float MoveSpeed = 300f;
[Export] public float JumpForce = -550f;
[Export(PropertyHint.Range, "0,1000,10")] public float Gravity = 1200f;
[Export] public PackedScene BulletPrefab;
#endregion
#region 6. 公共字段/属性
public int CurrentHealth { get; private set; }
public int MaxHealth { get; private set; } = 100;
public bool IsDead => CurrentHealth <= 0;
#endregion
#region 7. 私有字段
private Vector2 _moveInput;
private bool _isGrounded => IsOnFloor();
private AnimationPlayer _animPlayer;
#endregion
#region 8. 生命周期方法(按执行顺序排列)
public override void _EnterTree()
{
// 初始化、信号绑定
}
public override void _Ready()
{
// 节点引用获取、初始化逻辑
_animPlayer = GetNode<AnimationPlayer>("AnimationPlayer");
CurrentHealth = MaxHealth;
}
public override void _Process(double delta)
{
// 帧更新逻辑、输入检测
}
public override void _PhysicsProcess(double delta)
{
// 物理逻辑、移动逻辑
}
public override void _ExitTree()
{
// 信号解绑、资源释放
}
#endregion
#region 9. 公共方法
public void TakeDamage(int damage)
{
// 公共业务逻辑
}
public void Heal(int amount)
{
// 公共业务逻辑
}
#endregion
#region 10. 私有方法
private void Move()
{
// 内部逻辑
}
private void Jump()
{
// 内部逻辑
}
#endregion
}
}
2.3 架构规范
- 单例规范:全局管理器必须使用 Autoload 节点实现,禁止使用静态单例类,避免切换场景时丢失引用,Autoload 节点必须继承Node类,实现单例逻辑。
- 解耦规范: 跨节点、跨模块通信优先使用信号,禁止硬编码节点引用、静态类调用 业务逻辑与 UI 逻辑分离,UI 仅负责展示与输入,不处理核心业务逻辑 推荐使用 MVVM 架构,适配 Godot 的信号系统,实现 UI 与业务逻辑的完全解耦
- 复用规范: 可复用的功能模块必须封装为独立的场景预制体,禁止重复代码 通用工具方法必须封装为静态工具类,禁止在多个脚本中重复实现 可复用的 UI 控件必须封装为自定义控件场景,统一管理样式与逻辑
- 场景继承规范: 相同类型的场景(如敌人、道具)使用场景继承,复用基础逻辑与节点结构,对标 Unity 的 Prefab Variant 基础脚本使用抽象类、接口封装,子类实现具体逻辑,符合面向对象的开闭原则。
3. 版本控制规范(Git 专属,团队协作必做)
针对 Godot 项目的特点,制定 Git 版本控制规范,避免团队协作时出现冲突、资源丢失、引用断裂等问题,对标 Unity 的 Git 版本控制规范。
3.1 .gitignore 文件配置(必须使用)
代码块
PlainText
# Godot编辑器缓存与临时文件
/.godot/
*.import
*.translation
*.remap
# 构建与导出文件
/build/
/export/
/Bin/
/Obj/
*.pck
*.exe
*.apk
*.ipa
*.app
# C#构建缓存
/.vs/
/.rider/
*.csproj.user
*.sln.DotSettings.user
/[Ll]ogs/
/[Tt]emp/
*.suo
*.user
*.userosscache
*.pidb
# 系统文件
.DS_Store
Thumbs.db
Desktop.ini
# 调试文件
*.pdb
*.mdb
*.debug
3.2 版本控制核心规则
- 必须提交的文件: 项目根目录的project.godot文件(项目核心配置) 所有.cs脚本文件、.tscn场景文件、.tres资源文件 美术、音频、Shader 等原始资源文件(禁止提交.import 文件夹) 项目文档、配置文件、构建脚本
- 禁止提交的文件: .godot/文件夹:编辑器本地缓存,每个开发者的本地配置不同,提交会导致冲突 .import/文件夹:引擎自动生成的导入缓存,提交会导致资源引用冲突 构建、导出的可执行文件、PCK 包、安装包 本地编辑器配置、IDE 配置文件
- 分支管理规范: main分支:主分支,仅存放发布的稳定版本,禁止直接提交 develop分支:开发分支,存放最新的开发代码,所有功能分支从这里拉取 feature/xxx分支:功能分支,开发新功能,完成后合并到 develop 分支 hotfix/xxx分支:热修复分支,修复线上版本 bug,完成后合并到 main 和 develop 分支
- 提交规范: 提交信息必须清晰,格式为类型: 内容,如feat: 实现玩家移动逻辑、fix: 修复场景切换崩溃bug 禁止单次提交大量文件,按功能模块拆分提交,方便回滚与代码审查 提交前必须本地测试,确保代码无编译错误、功能正常,禁止提交无法运行的代码
3.3 团队协作冲突规避
- 场景文件冲突规避: 禁止多个开发者同时编辑同一个场景文件,大型场景拆分为多个子场景,每个开发者负责一个子场景 场景文件使用文本格式存储(Godot 默认),方便 Git 合并,禁止使用二进制格式
- 项目设置冲突规避: project.godot文件仅由项目负责人修改,其他开发者禁止提交该文件,避免项目配置冲突 输入映射、渲染设置、导出配置修改前,必须同步团队,避免冲突
- 资源引用规范: 所有资源引用必须使用相对路径,禁止使用绝对路径 资源文件重命名、移动后,必须重新绑定引用,避免引用丢失 禁止直接修改其他开发者负责的资源文件,修改前必须同步。
4. 大型项目团队协作通用规范
- 编辑器配置统一:团队所有成员使用完全相同版本的 Godot .NET 编辑器、导出模板、.NET SDK 版本,避免版本不一致导致的兼容性问题。
- 文档规范:所有核心系统、接口、功能必须编写开发文档,存放在07_Docs/目录下,新功能开发前必须先写设计文档,评审通过后再开发。
- 代码审查规范:所有功能分支合并到 develop 分支前,必须经过代码审查,确保代码符合规范、无 bug、无性能问题。
- 自动化构建规范:搭建 CI/CD 自动化构建流水线,提交代码后自动触发编译、打包、测试,确保代码可正常构建,对标 Unity 的自动化构建方案。
- 测试规范:核心功能必须编写单元测试,每个版本发布前必须完成全量测试,避免线上 bug。
第六部分预告
第六部分(最终章)将完整讲解:
- Unity 项目完整迁移到 Godot 的实战流程、工具、避坑指南
- Godot 高级特性(GDExtension、多线程、网络、XR)的 C# 应用
- 商业级游戏完整架构设计,从 0 到 1 搭建可落地的 Godot 项目框架
- Unity 开发者转 Godot 的终极避坑指南,99% 的踩坑点汇总与解决方案
免责声明:本文系网络转载或改编,未找到原创作者,版权归原作者所有。如涉及版权,请联系删