运行/调试配置

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

有两种运行/调试配置：

临时 — 每次运行/调试测试、测试套件、夹具或 main() 条目时创建，使用边距图标 /。
永久—由模板显式创建或通过保存临时配置创建。永久配置将作为您项目的一部分，直到您删除它们。

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

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

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

创建永久运行/调试配置

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

将临时运行/调试配置保存为永久配置。
从模板创建或复制现有配置。

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

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

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

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

转到运行 | 编辑配置。或者，按 Alt+Shift+F10 ，然后 0。
在运行/调试配置对话框中，点击工具栏上的或按 Alt+Insert。该列表显示运行/调试配置模板。
在名称字段中指定运行/调试配置名称。此名称将用于在列表和菜单中标识运行/调试配置。
如果您希望允许同时运行多个配置实例，请选择允许多个实例(U)。如果禁用此选项，尝试重新运行配置将终止活动会话。
根据选择的模板，填写配置设置。例如， CMake 应用程序、自定义构建应用程序、 Gradle / Gradle 本机应用程序。
在启动前部分中，定义是否要在启动应用程序之前执行任何特定操作，例如启动一个外部工具或另一个构建配置。要跳过构建阶段，请从启动前列表中移除构建。
您可以立即运行该配置，也可以保存配置以便稍后运行。
- 要保存运行配置以供稍后运行，请点击确定。
- 若要立即运行此配置，请点击运行。

启动前

在此区域，您可以指定在开始选定的 run/debug 配置之前要执行的任务。任务按它们在列表中出现的顺序执行。

项目	快捷方式	描述
	`Alt+Insert`	点击此图标以添加以下可用任务之一：运行外部工具：选择运行外部应用程序。在打开的对话框中，选择一个或多个您想要运行的应用程序。如果它在 CLion 中尚未定义，请添加其定义。如需更多信息，请参阅外部工具和外部工具。运行另一个配置：选择执行另一个运行/调试配置，并等待其完成后再开始当前配置。如果您想并行运行多个配置，请使用 compound run/debug configuration。运行File Watcher ：选择此选项以让 CLion 应用所有当前活动的文件监视器。运行Grunt 任务：选择此选项来运行 Grunt 任务。在打开的 Grunt 任务对话框中，指定定义所需任务的 Gruntfile.js ，选择要执行的任务，并指定传递给 Grunt 工具的参数。指定 Node.js 解释器的位置、要传递给它的参数，以及 grunt-cli 包的路径。运行gulp 任务：选择此选项以运行 Gulp 任务。在打开的 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`	点击此图标可编辑选定的任务。在打开的对话框中进行必要的更改。
	`Alt+Up` `Alt+Down`	点击这些图标以在列表中将所选任务上移或下移一行。任务将按照它们在列表中出现的顺序执行。
显示此页面		选择此复选框，以便在实际启动运行/调试配置之前显示运行/调试配置设置。
激活工具窗口		默认情况下，此复选框处于选中状态，并且在您启动 run/debug 配置时， Run 或 Debug 工具窗口会打开。否则，如果复选框未选中，工具窗口将被隐藏。但是，在配置运行时，您可以通过按 `Alt+4` 或 `Alt+5` 自行打开相应的工具窗口。

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

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

转到运行 | 编辑配置。或者，按 Alt+Shift+F10 ，然后 0。
请选择您要共享的运行/调试配置，启用存储为项目文件(S) 选项，并指定配置文件的存储位置。
您可以配置任何位置，除非需要与 CLion 2019.3 及更早版本兼容。为了与这些版本兼容，请将文件存储在建议的位置。
（可选）如果将 .idea 目录添加到 VCS 忽略文件中，那么 .idea/runConfigurations 子文件夹也将被忽略。如果项目使用 Git，您可以共享 .idea/runConfigurations 并保留 .idea 被忽略，通过修改 .gitignore 如下：
/.idea/* !/.idea/runConfigurations

运行/调试配置模板

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

配置模板的默认值

转到运行 | 编辑配置。或者，按 Alt+Shift+F10 ，然后 0。
在运行/调试配置对话框的左侧窗格中，点击编辑配置模板…。
在打开的运行/调试配置模板对话框中，选择一个配置类型。
请指定所需的默认参数，然后点击确定以保存模板。

环境变量和程序参数

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

转到运行 | 编辑配置。或者，按 Alt+Shift+F10 ，然后 0。
在打开的运行/调试配置对话框中，选择一个您希望传递参数并添加环境变量的配置。
在程序参数字段中输入参数。参数应以空格或换行符分隔。
点击以展开文本字段，这样您可以将参数作为列表查看和编辑。
在环境变量字段中输入变量名称和值： <name>=<value>。如果添加多个变量，它们应以分号分隔。
或者，点击并将变量名称和值添加到用户环境变量(S) 列表。
在打开的对话框中，您还可以看到可用的系统环境变量列表。清除系统环境变量复选框，如果您不想为所选配置使用系统环境变量。
您可以使用 $VAR$ 语法引用现有变量，包括父环境变量。请注意，此类引用区分大小写：例如，Linux/macOS 使用 PATH=xxx:$PATH$ ，Windows 使用 Path=xxx;$Path$。引用现有变量目前不适用于远程工具链（CPP-15693）。
另请参阅 CMake 环境。
使用从文件加载变量字段指向一个脚本，该脚本配置 CLion 的环境。此选项适用于 CMake、 Makefile、 Gradle 本机、自定义构建和测试配置（Boost.Test、 Catch、 Google Test、 Doctest、 CTest）。
在脚本中设置变量时使用以下语法：
set VAR=value
export VAR=value
请注意，由脚本创建的环境仅适用于相应配置的一次启动，并优先于自定义值。
指定的脚本将在所有执行前(B) 步骤完成后运行。