用途:在 Godot 4.7 的 .NET/C# 环境中编写游戏代码,包括节点子类、引擎生命周期、导出字段、信号事件与 GDScript 互操作。需要安装 Godot .NET 编辑器版本与匹配的 .NET 8 SDK,标准版无法运行 C#。首次创建 C# 脚本会生成 .csproj/.sln,可用编辑器或 dotnet build 构建。
主要能力:每个节点脚本是继承 Godot 类型的 partial 类(源生成器依赖 partial),文件名与类名应一致;以 PascalCase 覆写生命周期 _Ready()、_Process(double delta)、_PhysicsProcess(double delta);用 [Export] 暴露可在检查器中调整的字段;用 [Signal] 委托声明信号,委托名须以 EventHandler 结尾,用 EmitSignal(SignalName.Xxx, ...) 发出,并可像普通 C# 事件一样订阅;用 GetNode<T>("Path") 取节点;用 Call/Get/Set 调用 GDScript。
常见模式:节点脚本中结合生命周期、[Export] 与 GetNode;信号作为 C# 事件;用 GD.Load<PackedScene> 加载场景并 Instantiate<Node2D>() 实例化;通过 Call("take_damage", 10)、Get("score")、Connect("died", Callable.From(OnDied)) 与 GDScript 节点交互。
限制与注意:忘记 partial 会导致 [Export]/[Signal] 构建报错;方法名大小写或签名不符(需 PascalCase 且 delta 为 double)将不会被调用;[Signal] 委托名须以 EventHandler 结尾;用 GD.Print/GD.PrintErr 而非 Console.WriteLine;Vector2、Color、Transform2D 是值类型结构体,需修改本地副本再赋值;优先 QueueFree(),已释放对象再用会抛 ObjectDisposedException;.NET 导出到部分平台(如 Web、移动端)可能有额外步骤。更多导出属性变体、await ToSignal、集合类型与自定义 Resource 等内容见技能内参考文档。相关技能:godot-gdscript、godot-signals-groups、godot-resources、unity-csharp-scripting。