# 路径变量

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

路径变量是绝对文件系统路径的占位符。 借助它们，可以用带名称的变量替换硬编码的绝对路径。 这使项目配置可在不同机器之间移植。

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

CLion 中有两个预定义变量：  `$USER_HOME$`  表示您的主目录，  `$PROJECT_DIR$`  表示存储项目的目录。

您可以在配置 [外部工具](configuring-third-party-tools.html)和以下类型的运行/调试配置时引用路径变量：

* [CMake 应用程序](run-debug-configuration-application.html)

* [自定义构建应用程序](custom-build-targets.html#custom-rundebug)

* [Gradle 原生应用程序](run-debug-configuration-gradle-native-application.html)

> **Note:**
> 路径变量不能在 [CMakeLists.txt](cmakelists-txt-file.html)脚本中使用。

Procedure: 创建和使用路径变量

例如，当您的程序从文件中获取输入数据时，您可以为文件位置创建一个路径变量，然后在通过 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)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (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)，输入新变量的名称（例如，  `DATA_PATH` ）及其指向磁盘上数据文件目标目录的值：

![创建新的路径变量](https://resources.jetbrains.com/help/img/idea/2026.3/cl_pathvariables_create.png)

3. 在配置设置中，点击必填字段中的 ![添加按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.add_dark.svg)（本示例中为   重定向输入  ）。 在   宏  对话框中选择变量：

![在配置中使用路径变量](https://resources.jetbrains.com/help/img/idea/2026.3/cl_pathvariables_rdconfig.png)

4. 选中   存储为项目文件  复选框并指定存储配置文件的位置：

![将配置保存到文件中](https://resources.jetbrains.com/help/img/idea/2026.3/cl_rdconfig_withpathvariable_share.png)

5. 您可以检查此文件的内容（默认情况下为  `<project directory>.idea/runConfiguration/<configuration name>.xml` ）：

![配置的 .xml 文件中的路径变量](https://resources.jetbrains.com/help/img/idea/2026.3/cl_rdconfig_xml_pathvariable.png)

6. 现在，如果您通过 VCS 共享此  `.xml` 文件，您的团队成员将获得包含  `$DATA_PATH$` 的配置，并且他们可以更改值以指向其输入数据文件的位置。

Procedure: 忽略路径变量

每当您打开或更新项目时，CLion 会检查未解决的路径变量。 如果 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)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `外观与行为 | 路径变量` 。

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

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

