JetBrains Rider 2025.3 Help

Godot 支持

Rider 对 GDScript 提供了全面支持,包括原生 GDScript 支持与 LSP 集成。 这使得代码分析、导航、类型提示和符号解析等功能具有极高的准确性和覆盖率。 LSP(语言服务器)和 DAP(调试适配器协议)均会自动配置。

JetBrains Rider 广受好评的 代码分析编码辅助代码导航 功能可用于 Godot 项目中的 C# 和 GDScript 代码。

Godot 支持基于 Rider 捆绑的两个开源插件: Godot Support (负责整体 Godot 功能)与 GdScript (提供 GDScript 语言的原生支持)。

开始使用

只要在您的计算机上安装了 Godot Engine ,JetBrains Rider 就可以开始处理 Godot 项目。

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

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

  • 如果项目使用 C#,请通过 文件 | 打开 | 打开 打开项目文件夹中的解决方案文件 .sln

  • 要将 JetBrains Rider 设置为 Godot 编辑器中 C# 脚本的默认编辑器,请在 Godot 编辑器菜单中导航到 编辑器 | 编辑器设置 | Dotnet | 编辑器 ,然后在 外部编辑器 下拉菜单中选择 JetBrains Rider

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

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

    对于旧版本的 Godot 编辑器,您可能需要在 执行标志 中指定以下内容: {project} --line {line} {file}

为 Rider 优化 Godot 编辑器

以下是将 Godot 编辑器配置为与 Rider 最佳集成推荐的设置。 要访问这些设置,请确保在 编辑器设置 对话框顶部启用了 高级设置 开关。

  • 编辑器设置 | 文本编辑器 | 行为 | 外部更改时自动重新加载脚本

  • 编辑器设置 | 接口 | 编辑器 | 失去焦点时保存

  • 编辑器设置 | 接口 | 编辑器 | 失去焦点时导入资源

操作 GDScript 代码

JetBrains Rider 可使用两种方式分析 GDScript 文件:

  • 通过 LSP 连接到 Godot 语言服务(通常是打开同一个项目的 Godot 编辑器)。 安装 Godot Engine 后,Godot 语言服务将在您的计算机上可用。

  • 使用由捆绑的 GdScript 插件提供的原生 Godot 解析器。

当 Rider 连接到 Godot LSP 服务器时,状态栏上会显示连接指示器。 如果 LSP 连接成功,将使用该连接进行分析,并禁用通过插件的原生分析。

JetBrains Rider:状态栏上的 Godot LSP 指示器

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

GDScript 中的代码补全

JetBrains Rider 提供对变量、常量、方法、信号、枚举、类、注解、节点、输入、组、元字段和资源的代码补全:

JetBrains Rider:GDScript 中的补全
JetBrains Rider:GDScript 中的补全
JetBrains Rider:GDScript 中的补全
JetBrains Rider:GDScript 中的补全

默认情况下,以下划线开头的变量和方法不会出现在补全列表中。 如果您想更改此行为,请在 JetBrains Rider 设置 的 语言与框架 | GDScript 页面中清除 在补全中隐藏 _private 成员 复选框 Ctrl+Alt+S

GDScript 中的转到声明/用法

您可以在符号和文件资源的用法上使用 转到声明Ctrl+B Ctrl 点击)。

如果您位于某个符号的声明处, 查找用法 Alt+F7 将帮助您查找其所有引用。

JetBrains Rider:GDScript 中的查找用法

GDScript 文件模板

将新 GDScript 文件添加到项目时,您可以使用从 Godot 源导入的文件模板:

JetBrains Rider:GDScript 文件模板

GDScript 中的快速文档

您可以看到 快速文档 Ctrl+Q ,这些内容是根据注释生成的:

JetBrains Rider:GDScript 中的快速文档

GDScript 中的参数信息

在编写或学习 GDScript 中的函数调用时,请使用 参数信息 Ctrl+P 查看可用方法签名的详细信息:

JetBrains Rider:GDScript 中的参数信息

嵌入提示

GDScript 文件中还包含专用的 嵌入提示

JetBrains Rider:GDScript 中的嵌入提示

GDScript 中的操作指示器

JetBrains Rider 会在左侧边缘添加多种不同的 操作指示器。 除了快速修复灯泡 快速修复图标 等常见指示器以外,您还可以使用以下 GDScript 专用指示器:

父类(超类)方法

JetBrains Rider:GDScript 中的操作指示器 - 超类方法

运行当前场景

JetBrains Rider:GDScript 中的操作指示器 - 运行当前场景

资源使用情况

JetBrains Rider:GDScript 中的操作指示器 - 资源使用情况

已连接信号

JetBrains Rider:GDScript 中的操作指示器 - 已连接信号

继承场景

JetBrains Rider:GDScript 中的操作指示器 - 继承场景

颜色选择器

JetBrains Rider:GDScript 中的操作指示器 - 颜色选择器

GDScript 中的代码格式设置

代码样式的一个重要方面是如何格式化代码,即如何使用空格、制表符和换行符来排列代码元素,是否以及如何使用制表符缩进,是否以及如何换行长行代码,等等。

JetBrains Rider 提供的广泛代码格式化规则集具有默认配置,考虑了许多最佳实践。 您可以 配置格式化规则的每个细节,并在代码中强制执行这些规则。 当 JetBrains Rider 使用 代码补全代码生成功能生成新代码时,应用 代码模板并执行 重构时,这些规则会被应用。 格式化规则也可以 应用于现有代码 ,包括当前选区、当前文件或更大范围,直至整个解决方案。

您可以在 JetBrains Rider 设置 的 编辑器 | 代码样式 | GDScript 页面 Ctrl+Alt+S 上配置 GDScript 的格式设置样式。

GDScript 支持中的当前限制

  • get_nodeget_parent 等不会被解析为实际节点,而只会作为通用 Node 类型:

  • get_window 方法(以及可能还有其他一些方法)会根据上下文(SubViewportWindow 等)返回不同的类,但返回值会被解析为基础 Viewport 类,因此若要获得代码补全,您需要手动指定类型。

  • 动态节点和运行时添加的节点在设计时无法预测,因此无法为其提供代码补全功能。

C# 支持

JetBrains Rider 为使用 C# 编写的 Godot 项目提供完整支持。 包括:

场景预览窗口

在 JetBrains Rider 中,您可以在专用的 场景预览 窗口中查看所选 .tscn 的节点树,或查看与给定 .gd 文件关联的所有 .tscn 文件的节点树:

JetBrains Rider:Godot 支持 - 场景预览窗口

您可以将节点从场景预览拖放到编辑器中的脚本中:

JetBrains Rider:Godot 支持 - 场景预览窗口 拖放

运行并调试

当您打开一个 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++ 支持

对于使用 Godot 引擎源代码进行开发的开发者,JetBrains Rider 提供对 C++ 开发的全面支持。 包括:

  • 具备代码补全与导航等功能的智能代码洞察

  • 代码检查和重构

  • 用于修改和扩展引擎的跨平台兼容性

  • 与构建系统和调试工具集成

测试 C# 项目

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

分析 C# 项目

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

JetBrains Rider: 分析 Godot 项目

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

最后修改日期: 2025年 12月 5日