C#/.NET

C# 是由微软开发的高级编程语言。Godot 支持将 C# 作为一种脚本语言的选择，与 Godot 自有的 GDScript 并列。

标准的 Godot 可执行文件并不自带 C# 支持。要为你的项目启用 C# 支持，你需要从 Godot 网站 下载 .NET 版本 的编辑器。

• C# 基础
• C# 语言特性
• C# 风格指南
• C# 诊断

C# 的 Godot API

Godot 是一个通用的游戏引擎，它提供了一些高级功能作为它的 API 的一部分。下面的文章介绍了这些功能如何与 C# 集成，以及 C# API 和 GDScript 之间可能存在的差异。

• C# API 与 GDScript 的差异
• C# 集合
• C# Variant
• C# 信号
• C# 导出属性
• C# 全局类

C# 平台支持

从 Godot 4.2 开始，用 C# 编写的项目支持所有桌面平台（Windows、Linux 和 macOS），以及 Android 和 iOS。

Android 支持目前是实验性的，存在部分限制。

• 针对 Android 的项目需要指定 .NET 7.0 或更高版本。这需要修改 Godot 为现有项目生成的 .csproj 文件。以下属性会添加到用 4.2 创建的新项目中，也可以添加到现有项目中：

  <TargetFramework Condition=" '$(GodotTargetPlatform)' == 'android' ">net7.0</TargetFramework>

• 只支持部分 Android 架构： arm64 和 x64 。

iOS 支持目前是实验性的，存在部分限制。

• 针对 iOS 的项目需要指定 .NET 8.0 或更高版本。这需要修改 Godot 为现有项目生成的 .csproj 文件。以下属性会添加到用 4.2 创建的新项目中，也可以添加到现有项目中：

  <TargetFramework Condition=" '$(GodotTargetPlatform)' == 'ios' ">net8.0</TargetFramework>

• 用于 iOS 模拟器的官方导出模板仅支持 x64 架构。

• 导出到 iOS 只能从 MacOS 设备上完成。

目前，用 C# 编写的项目无法导出到 Web 平台。要在该平台上使用 C#，请考虑 Godot 3。