JetBrains Rider 2025.1 Help

Godot 支持

对 Godot 的支持基于开源的 Rider 的 Godot 支持 插件。 该插件随 Rider 捆绑提供,因此无需手动安装。

但是,如果您经常处理 GdScript 文件,可以通过另一个由社区支持的插件 GdScript 来进一步扩展这些文件的功能集。

开始使用

大多数情况下,您在机器上安装 Godot Engine 后,JetBrains Rider 就可以立即处理 Godot 项目。

您可以通过多种方式在 JetBrains Rider 中打开 Godot 项目:

  • 如果项目仅使用 GdScript,请从主菜单中选择 文件 | 打开 | 打开 ,选择项目文件夹,然后单击 选择文件夹

  • 如果项目使用 C#,请从主菜单中选择 文件 | 打开 | 打开 ,并选择项目文件夹中的解决方案文件 .sln

  • 将 JetBrains Rider 设置为 Godot 编辑器中 C# 脚本的默认编辑器。 此时,您可以在 Godot 编辑器视图中双击 C# 文件以在 JetBrains Rider 中打开它们。 为此,请在 Godot 编辑器菜单中选择 编辑器 | 编辑器设置 | Dotnet | 编辑器 ,然后在 外部编辑器 中选择 JetBrains Rider 和 Fleet

  • 类似地,您可以在 文本编辑器 | 外部 设置页面将 JetBrains Rider 设置为默认 GdScript 编辑器。

    要找到 JetBrains Rider 可执行文件的位置,请切换到 Rider,转到 帮助 | 诊断工具 | 特殊文件和文件夹 ,并查找 安装主目录。 在 Windows 上,您需要指向 bin/Rider64.exe 。 在 macOS 上,您需要指向 Rider 的 .app 文件夹。

    执行标志 中,指定以下内容: {project} --line {line} {file}

处理代码

JetBrains Rider 在处理 Godot 项目中的 C# 和 GdScript 代码时,提供了广受认可的 代码分析编码辅助代码导航 功能。

在 GDScript 中的代码分析是通过 LSP 协议借助 Godot 语言服务完成的。 当您安装 Godot Engine 时,Godot 语言服务会在您的机器上可用。

默认情况下,JetBrains Rider 与正在运行的 Godot 编辑器建立 LSP 连接。 但是,如果您不想让 Godot 编辑器运行,可以让 Rider 在需要时自动在后台启动 Godot LSP 服务。 为此,请在 语言与框架 | Godot 引擎 设置页面  Ctrl+Alt+S 内,选择 LSP 服务器连接: 中的 自动启动无头 LSP 服务器

运行并调试

当您打开一个 Godot 项目时,JetBrains Rider 会自动创建一个或多个 运行配置 ,供您用于 运行调试 游戏。 Godot 项目的调试通过 Debug Adapter Protocol (DAP) 进行。

仅包含 C# 代码的 Godot 项目与包含 GDScript 或混合 GDScript/C# 代码的项目在运行时存在一些差异。

使用 C# 代码运行和调试 Godot 项目

  1. 如果您准备调试您的项目,请在需要的地方设置 断点

  2. 使用 玩家 运行配置启动您的项目。 此配置会在您打开 Godot 项目时自动创建。

    JetBrains Rider: 启动 Godot 项目
  3. 或者,您可以从您的 Godot/C# 项目启动单个场景。 为此,请右键单击场景文件 .tscn 并选择 调试 '[场景名称]'

包含 GDScript 代码的 Godot 项目只能在 JetBrains Rider 中通过调试器启动。 要在不调试的情况下运行此类项目,请使用 Godot 编辑器。

使用 GDScript 代码调试 Godot 项目

  1. 确保 Godot 编辑器正在运行且打开了相同的项目。

    如果未运行,您可以通过单击工具栏上的 Godot 图标并选择 启动 Godot 编辑器 从 JetBrains Rider 启动它。

    JetBrains Rider: 启动 Godot 编辑器
  2. 如果您准备调试您的项目,请在需要的地方设置 断点

  3. 使用 玩家 GDScript 运行配置启动您的项目。 此配置会在您打开 Godot 项目时自动创建。

调试 GDScript 和 C#

  1. 按照 上文 所述,使用 Player GDScript 配置开始调试会话。

  2. Ctrl+Alt+F5 或从主菜单中选择 运行 | 附加到进程

  3. 在列表中选择所需的 Godot 进程并单击 使用 .NET 调试器附加

测试和分析 C# 项目

如果您在 C# Godot 项目中使用 gdUnit4Net 单元测试框架,您可以使用其丰富的 单元测试 功能。

要分析 C# Godot 项目的 性能内存 ,请单击自动创建的 玩家 运行配置旁的三点菜单,并选择所需的 分析类型

JetBrains Rider: 分析 Godot 项目

有关更多信息,请参阅 Godot 引擎中的 原始拉取请求

最后修改日期: 2025年 7月 31日