JetBrains Rider 2025.2 Help

运行/调试配置

JetBrains Rider 使用运行/调试配置来运行、调试、部署和测试您的代码。 每个配置是一组命名的启动属性，用于定义要执行的内容以及应使用的参数和环境。

有两种 run/debug 配置：

  • 临时——每次从编辑器运行/调试 .NET 静态方法 时创建。

  • 永久—由模板显式创建或通过保存临时配置创建。 永久配置将作为您项目的一部分，直到您删除它们。

每当您运行、调试或测试代码时，JetBrains Rider 要么使用现有的永久运行/调试配置，要么创建一个新的临时配置。

永久配置的图标是不透明的，而临时配置的图标是半透明的。 配置图标上的红色叉号表示配置设置中存在错误。

临时配置的最大数量为 5。 添加新版本时，旧版本会被自动删除。 如有必要，您可以在 设置/首选项 | 高级设置 | 运行/调试 | 临时配置限制 中增加此限制。

创建永久运行/调试配置

JetBrains Rider 提供以下方法来创建永久运行/调试配置：

将临时配置保存为永久配置

  • 在 run/debug 配置切换器中选择一个临时配置，点击 / 并选择 保存配置。

    JetBrains Rider：保存临时运行/调试配置

  • 或者，在“运行/调试配置”对话框中选择一个临时配置，然后点击工具栏上的 保存。

JetBrains Rider 为不同的语言、工具和框架提供运行/调试配置 模板。 可用模板的列表会因已安装和启用的 plugins 而有所不同。

从模板创建运行/调试配置

  1. 转到 运行 | 编辑配置。 或者，按 Alt+Shift+F10 ，然后 0。

  2. 在 运行/调试配置 对话框中，点击工具栏上的 或按 Alt+Insert。 该列表显示运行/调试配置模板。

    选择所需的模板。 如果您不确定选择哪个模板，请参阅 运行/调试配置模板列表 以获取有关特定模板的更多信息。

  3. 在 名称 字段中指定运行/调试配置名称。 此名称将用于在列表和菜单中标识运行/调试配置。

  4. 如果您希望允许同时运行多个配置实例，请选择 允许多个实例(U)。 如果禁用此选项，尝试重新运行配置将终止活动会话。

  5. 配置运行/调试配置参数。 必需参数和可选参数的列表可能因所选运行/调试配置类型而异。

    某些可选参数是隐藏的。 要查看并启用它们，请单击 修改选项 链接。

    有关所选模板的详细描述，请参阅 运行/调试配置参考的相应部分。

  6. 在 启动前 部分中，定义是否要在启动应用程序之前执行任何特定操作，例如启动一个 外部工具 或另一个构建配置。 要跳过构建阶段，请从 启动前 列表中移除 构建。

    有关特定 启动前 活动的更多信息，请参阅 启动前。

  7. 您可以立即运行该配置，也可以保存配置以便稍后运行。

    • 要保存运行配置以供稍后运行，请点击 确定。

    • 若要立即运行此配置，请点击 运行。

启动前

在此区域，您可以指定在启动所选运行/调试配置之前要执行的任务。 任务按照它们在列表中出现的顺序执行。

条目

快捷方式

描述

添加按钮

Alt+Insert

点击此图标以添加下列可用任务之一：

  • 运行外部工具 ：选择运行外部应用程序。 在打开的对话框中，选择一个或多个您想要运行的应用程序。 如果它在 JetBrains Rider 中尚未定义，请添加其定义。

  • 运行另一个配置 ：选择执行另一个运行/调试配置，并等待其完成后再开始当前配置。 如果您想并行运行多个配置，请使用 复合运行/调试配置。

  • 构建解决方案 ：选择此选项以在启动配置之前构建解决方案。

  • 运行File Watcher ：选择此选项以让 JetBrains Rider 应用所有当前活动的 文件监视器。

  • 运行远程外部工具 ：添加一个 远程 SSH 外部工具。

  • 运行Grunt 任务 ：选择此选项来运行 Grunt 任务。

    在打开的 Grunt task 对话框中，指定定义所需任务的 Gruntfile.js ，选择要执行的任务，并指定传递给 Grunt 工具的参数。

    指定 Node.js 解释器的位置、传递给它的参数，以及 grunt-cli 包的路径。

  • 运行gulp 任务 ：选择此选项以运行 Gulp task。

    在打开的 Gulp 任务 对话框中，指定定义所需任务的 Gulpfile.js ，选择要执行的任务，并指定要传递给 Gulp 工具的参数。

    指定 Node.js 解释器的位置、传递给解释器的参数以及到 gulp 包的路径。

  • 运行npm 脚本 ：选择此选项来执行一个 npm 脚本。

    在 NPM Script 对话框中，指定 npm run/debug configuration settings。

  • 编译TypeScript ：选择运行内置的 TypeScript 编译器，从而确保您对 TypeScript 代码所做的所有更改都反映在生成的 JavaScript 文件中。 在打开的 TypeScript 编译设置 对话框中，选择或清除此 检查错误 复选框，以配置编译器在检测到错误时的行为:

    • 如果选中了 检查错误 复选框，编译器会显示所有错误，并且运行配置将不会启动。

    • 如果清除了 检查错误 复选框，编译器将显示所有检测到的错误，但运行配置仍将启动。

  • 生成CoffeeScript 源映射 ：选择此选项以生成 CoffeeScript 源代码的源映射。 在打开的对话框中，指定您的 CoffeeScript 源文件所在的位置。

  • 上传文件到远程主机 ：选择此选项以根据 默认服务器访问配置自动 上传应用程序文件到服务器。

"移除"按钮

Alt+Delete

点击此图标可将所选任务从列表中移除。

编辑

Enter

点击此图标可编辑选定的任务。 请在打开的对话框中进行必要的更改。

方法向上

方法 down

Alt+Up

Alt+Down

点击这些图标以在列表中将所选任务上移或下移一行。 任务将按照它们在列表中出现的顺序执行。

显示此页面

选中此复选框以在实际启动运行/调试配置之前显示运行/调试配置设置。

激活工具窗口

默认情况下，此复选框处于选中状态，并且在您启动 run/debug 配置时， Run 或 Debug 工具窗口会打开。

否则，如果复选框未选中，工具窗口将被隐藏。 但是，当配置正在运行时，您可以通过按 Alt+4 或 Alt+5 自行打开相应的工具窗口。

启动运行配置

您可以通过以下方式之一启动现有的运行配置：

  • 如果在 Run widget中已选择该运行配置，请单击其旁边的 ，或按 Shift+F10。

    运行小部件旁的“Run”按钮

  • 如果您想选择其他运行配置，请单击 Run widget。 在打开的菜单中，单击您想启动的运行配置旁的 。

    运行小部件菜单中运行配置旁的“Run”按钮

  • 按下 Alt+Shift+F10。 在打开的菜单中，点击您想启动的运行配置。

共享运行/调试配置

您可能希望共享您的 run/debug 配置，以便您的团队成员可以使用相同的配置运行应用程序，或者使他们能够远程附加到您正在运行的进程。

JetBrains Rider 提供了一种机制，可以将您的 run/debug 配置存储为项目文件并通过 VCS 共享。 当您希望将配置作为文件发送给其他人、创建运行/调试配置的本地备份或从文件导入它们时，也可以使用相同的机制。

  1. 转到 运行 | 编辑配置。 或者，按 Alt+Shift+F10 ，然后 0。

  2. 请选择您要共享的 run/debug 配置，启用 存储为项目文件(S) 选项，并指定配置文件的存储位置。

    默认情况下，共享配置保存在解决方案目录中的 .运行 文件夹中。

运行/调试配置模板

所有运行/调试配置都基于模板，这些模板实现了启动逻辑，定义参数列表及其默认值。 安装中预定义了 可用模板列表 ，只能通过 插件进行扩展。 但是，您可以编辑每个模板中的默认参数值，以便于新运行/调试配置的设置。

配置模板的默认值

  1. 转到 运行 | 编辑配置。 或者，按 Alt+Shift+F10 ，然后 0。

  2. 在 run/debug 配置对话框的左侧窗格中，点击 编辑配置模板…。

  3. 在打开的 运行/调试配置模板 对话框中，选择一个配置类型。

  4. 请指定所需的默认参数，然后点击 确定 以保存模板。

环境变量和程序参数

您可以通过向合适的运行/调试配置添加程序参数和环境变量来影响应用程序的运行时行为。

  1. 转到 运行 | 编辑配置。 或者，按 Alt+Shift+F10 ，然后 0。

  2. 在打开的 运行/调试配置 对话框中，选择一个您想要传递参数并添加环境变量的配置。

    程序实参

  3. 在 程序实参 字段中输入参数。 参数应以空格或换行符分隔。

    点击 展开字段图标 以展开文本字段，这样您可以将参数作为列表查看和编辑。

  4. 在 环境变量 字段中输入变量名称和值： <名称>=<值>。 如果添加多个变量，它们应以分号分隔。

    或者，点击 环境变量图标 并将变量名称和值添加到 用户环境变量(S) 列表。

    添加环境变量

    在打开的对话框中，您还可以看到可用的系统环境变量列表。 清除 系统环境变量 复选框，如果您不想为所选配置使用系统环境变量。

    您可以使用 $VAR$ 语法引用现有变量，包括父环境变量。 请注意，此类引用区分大小写：例如， PATH=xxx:$PATH$ 用于 Linux/macOS， Path=xxx;$Path$ 用于 Windows。

运行/调试配置文件夹

当有许多相同类型的 run/debug 配置时，您可以将它们分组到文件夹中以便于访问。

为运行/调试配置创建一个文件夹

  1. 转到 运行 | 编辑配置。 或者，按 Alt+Shift+F10 ，然后 0。

  2. 在 运行/调试配置 对话框中，选择配置类型并在工具栏上点击 新建文件夹图标。 已创建一个新的空文件夹用于所选类型。

  3. 请在右侧的文本框中指定文件夹名称或接受默认名称。

  4. 选择所需的 run/debug 配置并将它们移动到目标文件夹下。

  5. 应用这些更改。 如果一个文件夹是空的，它将不会被保存。

当您不再需要文件夹时，可以将其删除 Delete。 此文件夹下的 run/debug 配置将被移动到相应 run/debug 配置类型的根目录下。

服务工具窗口中的运行/调试配置

您可以在 服务 工具窗口中管理多个 run/debug 配置。 例如，您可以启动、暂停和停止多个应用程序，跟踪它们的状态，并检查特定于应用程序的详细信息。

将运行/调试配置添加到 服務 窗口

  1. 从主菜单中选择 视图 | 工具窗口 | 服务 或按 Alt+8。

  2. 在 服务 工具窗口中，点击 添加服务 ，然后选择 Run Configuration Type…。

    服务工具窗口：添加运行配置

  3. 从列表中选择运行/调试配置类型，将此类型的所有配置添加到窗口。

    请注意，工具窗口将仅显示您已 创建 一个或多个配置的配置类型。

在启动运行/调试配置之前执行任务

大多数类型的运行/调试配置都有 启动前 部分，您可以在其中指定在执行配置之前必须完成的任务。 例如，您可能希望在启动应用程序之前自动构建您的 解决方案。

要添加任务，请展开 启动前 部分，单击 添加 添加 ，选择所需的任务类型，并在需要时指定其参数。

您可以在启动运行/调试配置之前执行以下任务：

启动 Web 浏览器

在选定的 浏览器 中打开指定的 URL。

运行外部工具

启动在 外部工具 中配置的另一个应用程序。 在打开的对话框中，选择一个或多个您想要运行的应用程序。

运行另一个配置

启动另一个运行/调试配置。 与 复合 配置不同，这种运行多个配置的方式允许您定义配置启动的顺序。

构建项目

构建当前解决方案中的任何项目。 如果配置针对特定项目，您可以选择 所选项目 来构建配置设置中选择的项目。 如果编译过程中出现错误，JetBrains Rider 将不会尝试启动运行/调试配置。

清理项目

移除所有构建工件——指定项目的中间文件和输出文件。

构建解决方案

构建整个解决方案。

清理解决方案

移除所有构建工件——解决方案的中间文件和输出文件。

发布解决方案

运行文件监视器

应用所有当前活动的 文件监视器。

运行远程外部工具

执行 远程 SSH 外部工具。

运行 Grunt 任务

运行 Grunt 任务。

运行 gulp 任务

运行 Gulp 任务。

运行 npm 脚本

执行 npm 脚本。

编译 TypeScript

运行内置的 TypeScript 编译器，从而确保您对 TypeScript 代码所做的所有更改都反映在生成的 JavaScript 文件中。 在打开的 TypeScript 编译设置 对话框中，选择或清除此 检查错误 复选框，以配置编译器在检测到错误时的行为:

  • 如果选中了 检查错误 复选框，编译器会显示所有错误，并且运行配置将不会启动。

  • 如果清除了 检查错误 复选框，编译器将显示所有检测到的错误，但运行配置仍将启动。

生成 CoffeeScript 源地图

为您的 CoffeeScript 源生成源映射。 在打开的对话框中，指定您的 CoffeeScript 源文件所在的位置。

显示此页面

选中此复选框以在实际启动运行/调试配置之前显示运行/调试配置设置。

激活工具窗口

默认情况下，此复选框处于选中状态，并且在您启动 run/debug 配置时， Run 或 Debug 工具窗口会打开。

否则，如果复选框未选中，工具窗口将被隐藏。 但是，当配置正在运行时，您可以通过按 Alt+4 或 Alt+5 自行打开相应的工具窗口。

最后修改日期： 2025年 9月 26日
正在运行运行和调试 .NET 静态方法