JetBrains IDE 如何把运行配置参数保存到项目

在 JetBrains IDE 里，临时改好一次运行参数并不等于团队已经拥有这份配置。要让程序参数、环境变量和工作目录跟着项目走，需要在 Run/Debug Configurations 中选中配置，启用 Store as project file，再把生成的项目文件交给版本控制。这样新成员拉取项目后可以直接看到同名配置，只需补齐自己的本地变量。

官方地址：https://www.jetbrains.com/idea/

第 1 步：打开 Run/Debug Configurations

点击 IDE 顶部运行配置下拉框，选择 Edit Configurations。如果列表里还没有目标配置，点击左侧加号，按项目类型选择 Application、Kotlin、NPM 或其他对应模板；已经存在的配置则直接选中后编辑。这里要区分“运行配置”和“运行配置模板”：本文要保存的是当前项目实际使用的那一份配置。

进入窗口后，先把 Name 改成团队容易识别的名称，例如 Local App。名称不是功能开关，但它会影响团队成员在运行下拉框里能否快速找到正确入口。

第 2 步：把运行参数写进配置

在配置的设置页填写 Program arguments、Environment variables 和 Working directory。工作目录是相对输入输出路径的起点，适合写成项目内的相对位置或 IDE 宏，不要把个人电脑上的绝对路径当成共享配置。

例如，开发环境只需要一个不敏感的模式变量和一个固定参数时，可以按下面的形式记录。这里的注释说明示例用途，真正的敏感值应由本机环境提供。

# 仅作为运行配置示意：共享开发模式，不放入密码或令牌
APP_MODE=dev

# 程序参数示意：让应用读取项目内的配置目录
--config=./config

如果环境变量很多，可点击 Environment variables 旁的编辑入口，用表格逐项维护；也可以使用 IDE 支持的 .env 文件或脚本路径。无论采用哪种方式，都要确认文件本身是否应加入版本控制。

第 3 步：启用 Store as project file

仍在当前配置窗口，勾选 Store as project file，然后点击 Apply。JetBrains IDE 通常会把共享运行配置放到项目内的 .idea/runConfigurations；如果团队不希望提交整个 .idea 目录，也可以在文件位置管理入口中选择项目内的其他约定目录。

这个开关的关键作用是把配置从个人工作区状态变成项目文件。没有启用时，配置可能只存在于 workspace.xml，换电脑或换成员后就看不到。保存前顺手检查项目的忽略规则，避免刚生成的配置又被 Git 忽略。

第 4 步：检查敏感值和路径边界

共享不代表所有字段都要原样提交。密码、访问令牌、内部地址和本机绝对路径应替换为变量名、宏或本地配置文件。对于团队配置，可以提交一个不含秘密的示例变量名，并在 README 中说明每个人需要在哪里补值。

第 5 步：保存后验证团队可复用

点击 OK，重新打开顶部运行配置下拉框，选择刚保存的 Local App。先看配置名称旁是否能识别出它是项目级共享配置，再启动一次示例程序，重点观察 Run 窗口里的工作目录和参数摘要。验证的目标是“配置被正确读取”，不是把某台机器的运行结果当成团队标准。

如果需要模拟新成员环境，可以暂时清空本机的敏感变量，只保留共享文件，再检查 IDE 给出的缺失变量提示。缺变量时优先补齐本机环境，不要为了让配置立即启动而把真实密钥写回项目文件。

常见问题

为什么我勾选了共享配置，队友仍然看不到？

先确认生成的配置文件确实位于项目目录，并且没有被 .gitignore 排除；再确认文件已经提交并被队友拉取。只改了个人 workspace 状态不会产生可共享文件。

工作目录应该填项目根目录吗？

不一定。若程序用相对路径读取 config 或写入输出，工作目录应选让这些相对路径成立的项目内目录；能用项目宏就不要写个人绝对路径。

环境变量能不能全部提交？

只有不敏感、对团队有共同默认意义的值适合提交。密码、令牌和内部凭据应该留在本机环境或受控的秘密管理方案中。

保存成项目文件后还能保留个人差异吗？

可以。把团队共同字段放在共享配置里，个人差异放到本地环境变量、未提交的覆盖配置或 IDE 支持的本地文件中，避免让一个人的路径和端口成为全组默认值。