Godot C# 游戏开发

要解决什么问题

在 Godot 里用 C# 写玩法逻辑时，引擎 API 和 GDScript 习惯并不一一对应：partial 类、PascalCase 生命周期、[Export]/[Signal] 委托命名，以及 GetNode 与 GDScript 互调，都容易在「能编译」和「引擎真的会调用」之间踩坑。本技能聚焦 Godot 4.3+ 的 .NET / C# 脚本层，而不是场景、物理、动画等语言无关主题。

技能如何组织工作流

• 环境与工程：必须使用 Godot .NET 编辑器构建，并安装与版本匹配的 SDK（4.3/4.4 对应 .NET 6.0，4.5+ 对应 .NET 8）；首个 C# 脚本会生成 .csproj/.sln，可在编辑器或 dotnet build 下编译。
• 节点脚本形态：每个节点脚本是继承 Godot 类型的 partial class，文件名与类名应对齐节点脚本；生命周期重写为 _Ready()、_Process(double delta)、_PhysicsProcess(double delta)。
• Inspector 与信号：用 [Export] 暴露可调参数；用 [Signal] 声明以 EventHandler 结尾的委托，通过 EmitSignal(SignalName.Xxx, ...) 发射，并订阅生成的 C# 事件。
• 场景与互操作：用 GetNode("Path")（或 %Unique）取节点；需要时通过 Call/Get/Set 调用 GDScript；技能内还覆盖场景实例化、信号即 C# 事件等模式。

适用边界与注意点

• 不要用本技能替代：纯 GDScript 语法 → godot-gdscript；与语言无关的引擎概念 → 对应 godot-* 技能。
• 常见失败点：忘记 partial 会导致源生成器无法扩展类；生命周期方法名或 double delta 签名错误则回调不会被调用；Vector2 等 值类型 需整 struct 写回，不能直接改字段；日志用 GD.Print 而非依赖控制台；释放节点优先 QueueFree()，释放后访问会抛 ObjectDisposedException。
• 导出与平台：部分平台（Web/移动端等）的 .NET 导出步骤与标准构建不同，需查阅目标平台的 .NET 导出说明；Android 4.5 等场景可能涉及更高版本 SDK 要求。