# 路径变量

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/idea/llms.txt).

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

由于此类资源可能位于每位开发者计算机上的不同位置，用户定义的路径变量会存储为 [全局 IDE 设置](configuring-project-and-ide-settings.html)，而不是 [项目设置](configure-project-settings.html) 。 项目仅存储变量名称，而每位开发者在本地定义其值。 配置后，路径变量对于在你的 IntelliJ IDEA 实例中打开的所有项目都具有相同的值。

您可以使用路径变量来为 [外部工具](configuring-third-party-tools.html)和某些 [运行配置](run-debug-configuration.html)指定路径和命令行参数。 如需更多信息，请参阅 [内置 IDE 宏](built-in-macros.html)。

Procedure: 创建并使用新的路径变量

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

1. 按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `外观 & 行为 | 路径变量` 。

2. 点击 !["添加"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)并输入新变量的名称及其值，该值指向包含磁盘上文件的目标目录。

3. 将您的 JAR 文件添加为 [模块依赖项](working-with-module-dependencies.html#add-a-new-dependency)。

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

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

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

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

$USER_HOME$
: 当前用户的主目录。

$PROJECT_DIR$
: 当前项目的根目录。

$MODULE_WORKING_DIR$
: 当前 [module's root directory](working-with-projects.html)。

$MODULE_IML_DIR$
: 当前模块的  `.iml` 文件所在目录。

Procedure: 忽略路径变量

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

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

1. 按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `外观 & 行为 | 路径变量` 。

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

3. 点击   OK  以应用更改。