Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

C#/.NET¶

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

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

C# 的 Godot API¶

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

从 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。