Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

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。