JetBrains Rider 2025.1 Help

运行和调试可执行类型的 .NET 项目

您可以像运行其他项目类型一样运行和调试可执行类型的 .NET 项目(例如,控制台应用程序)——通过在 运行配置中配置项目启动属性,然后 附加调试器 Shift+F9 或不调试 Shift+F10 地启动此配置。

默认情况下,当您 创建或首次打开可执行类型的项目时,JetBrains Rider 会创建必要的运行配置。 您可以自定义此配置,或为不同的启动场景添加更多相同类型的配置。

为 .NET 项目创建运行配置

  1. 通过以下方法之一打开 运行/调试配置 对话框:

    • 请选择 运行 | 编辑配置 从主菜单。

    • 在 Navigation bar 可见 (查看 | 外观 | 导航栏) 的情况下,从运行/调试配置选择器中选择 编辑配置。

    • 请按 Alt+Shift+F10 然后按 0。

  2. 在 运行/调试配置 对话框中,单击 添加新配置 添加新配置 Alt+Insert ,选择 .NET 项目 配置类型,并指定一个名称,以便您将来识别此配置。

  3. 可选择调整配置的 通用设置 并配置 启动前任务。

  4. 选择一个可执行类型的启动项目。

  5. 在 目标框架 中,选择将用于运行此配置的 .NET 框架版本。

  6. 所选目标项目的可执行文件路径会自动计算,但如果需要,您可以更改它。

  7. (可选)指定在启动配置时将传递给可执行文件的程序参数。 多个参数应以空格分隔。

    对于某些项目类型(例如,Web 应用程序),JetBrains Rider 会自动填写此字段,以便目标项目可以正确启动。

  8. 可选地,指定自定义 工作目录 ,否则将使用目标可执行文件的目录。

  9. 可选地,以以下格式为目标可执行文件指定自定义 环境变量。

    envVar1=value1;envVar2=value2
  10. 可选地,指定 .NET 运行时实参。 多个参数应以空格分隔。

    .NET 和 Mono 都支持在启动应用程序时设置自定义运行时参数。 例如,Mono 支持 许多运行时参数 ,以自定义您的应用程序运行方式。 您可以选择要使用的垃圾回收器(--gc=boehm 或 --gc=sgen ),在 macOS 上,您可以选择要使用的运行时架构(--arch=32 或 --arch=64 ),以及更多选项。

  11. 可选地,使用 运行时 选择器选择您机器上可用的运行时之一。

    如果您在 Windows 上工作,您可以检查您的应用程序在 Mono 运行时下的运行情况。 JetBrains Rider 将使用在 JetBrains Rider 设置 的 构建、执行、部署 | 工具集和构建 页面上指定的 Mono 可执行文件 Ctrl+Alt+S。

    要使用 Mono 运行时进行调试,您需要:

    • Mono 4.2+

    • 项目中的便携式 PDB — <debugtype>portable</debugtype> 在 .csproj 文件中,或者通过 mdb与 pdb2mdb生成。

  12. 默认情况下,.NET 和 Mono 应用程序的输出显示在 运行 或 调试 窗口中。 您可以选择 使用外部控制台 在外部窗口中显示输出。

    请注意,此复选框不影响经典 .NET 应用程序类型(例如 .NET 控制台应用程序)——它们的输出始终显示在外部窗口中。

  13. 当您以调试模式运行配置时,JetBrains Rider 仅将其调试器附加到原始 .NET 进程。 如果您想调试由原始进程生成的子进程和孙子进程,请选择 附加到子 .NET 进程。

    请注意,此选项仅适用于 .NET 8 及更高版本。

  14. 点击 Apply 以保存配置。

为 Web 应用程序启动浏览器

在配置设置的 打开浏览器 部分中,您可以配置浏览器的行为并启用调试应用程序的客户端代码。 此功能通过 JavaScript 调试 运行配置提供,因此从技术上讲,JetBrains Rider 为服务器端和客户端代码创建了单独的运行配置,但您可以在一个专用的 .NET 项目运行配置中指定所有设置。

条目

描述

打开浏览器

在此区域的字段中,指定一个项目 HTML 文件,以根据项目根目录创建一个正确的网址,以便在内置 Web 服务器上启动。 例如,如果您选择 project_root/inner_folder/index.html ,生成的 URL 将是 http://localhost:63342/project_root/inner_folder/index.html 。 如果您选择 启动后 复选框,应用程序启动后浏览器将自动打开此页面。 或者,您可以通过在您选择的浏览器中手动打开具有此 URL 地址的页面来查看相同的结果。

启动后

选中此复选框以自动打开浏览器。 从列表中选择要使用的浏览器:

  • 要使用系统默认浏览器,请选择 默认。

  • 要使用自定义浏览器,请从列表中选择。 请注意,仅支持在 Google Chrome 和其他 基于 Chromium 的浏览器 中调试 JavaScript 客户端代码。

  • 若要配置浏览器,请点击 “浏览”按钮 并在打开的 Web 浏览器和预览 对话框中调整设置。 For more information, refer to 配置浏览器.

使用 JavaScript 调试器

选择此复选框以启用在所选浏览器中调试客户端代码。

2025年 7月 31日