IntelliJ IDEA 2026.1 Help

路径变量

路径变量是绝对文件系统路径的占位符。 它们允许你用命名变量替换硬编码的绝对路径。 这使得项目配置可以在不同的计算机之间移植。

由于这些资源可能在每位开发者的计算机上位于不同的位置,用户自定义路径变量会作为 全局 IDE 设置而不是 项目设置进行存储。 项目只存储变量名称,每位开发者在本地定义其值。 一旦配置完毕,路径变量在您所用 IntelliJ IDEA 中打开的所有项目中都会拥有相同的值。

您可以使用路径变量来为 外部工具和某些 运行配置指定路径和命令行参数。 如需更多信息,请参阅 内置 IDE 宏

创建并使用新的路径变量

例如,您希望将本地存储的 JAR 文件添加为模块依赖项,并通过 VCS 与您的团队成员共享此配置。

  1. Ctrl+Alt+S 打开设置,然后选择 外观 & 行为 | 路径变量

  2. 点击 "添加"按钮 并输入新变量的名称及其值,该值指向包含磁盘上文件的目标目录。

  3. 将您的 JAR 文件添加为 模块依赖项

  4. 请检查 .iml 文件。 依赖项是使用路径变量添加的。

在您的团队成员从 VCS 更新他们的项目后,他们将更改变量的值,以指向其电脑上的所需 JAR 文件。

请在接受路径变量的字段和配置文件中将变量称为 $var_name$

IntelliJ IDEA 还具有以下内置路径变量:

$USER_HOME$

当前用户的主目录。

$PROJECT_DIR$

当前项目的根目录。

$MODULE_WORKING_DIR$

当前 module's root directory

$MODULE_IML_DIR$

当前模块的 .iml 文件所在目录。

忽略路径变量

每当您打开或更新项目时,IntelliJ IDEA 会检查未解决的路径变量。 如果 IDE 检测到任何内容,它会要求您为其定义值。 如果您不打算使用包含未解析路径变量的文件或目录,您可以将它们添加到忽略变量列表中。

您还可以使用忽略变量列表,当传递给 run/debug 配置的程序参数与路径变量(例如,环境变量)格式相同时。

  1. Ctrl+Alt+S 打开设置,然后选择 外观 & 行为 | 路径变量

  2. 忽略的变量 字段添加 IntelliJ IDEA 不应视为路径变量的名称。

  3. 点击 确定 以应用更改。

2026年 3月 24日