JetBrains Rider 2025.2 Help

Godot 支持

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

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

开始使用

在您的机器上安装 Godot Engine 后,JetBrains Rider 即可开始与 Godot 项目协同工作。

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

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

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

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

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

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

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

JetBrains Rider 在 Godot 项目的 C# 和 GDScript 代码中提供广为认可的 代码分析智能编码辅助代码导航功能。

使用 GDScript 代码

JetBrains Rider 可以通过两种不同方式分析 GDScript 文件:

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

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

当 Rider 连接到 Godot LSP 服务器时,状态栏中会出现连接指示器。 若成功连接到 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 页面上配置 GDScript 的格式样式 Ctrl+Alt+S

GDScript 支持的当前限制

  • get_nodeget_parent 等不会被解析为实际的 Node,而仅被解析为通用的 节点 类型。

  • get_window 方法(以及可能的其他方法)根据上下文(如 SubViewport窗口 等)返回不同的类,但返回值被解析为基础的 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# Godot 项目的 性能内存 ,请单击自动创建的 玩家 运行配置旁的三点菜单,并选择所需的 分析类型

JetBrains Rider: 分析 Godot 项目

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

最后修改日期: 2025年 9月 26日