IntelliJ IDEA 2025.3 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年 1月 23日