PyCharm 2026.1 Help

路径变量

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

由于这些资源在每位开发者的计算机上可能位于不同位置,用户自定义路径变量被存储为 全局 IDE 设置而不是 项目设置。 项目只存储变量名称,每位开发者在本地定义其值。 配置完成后,路径变量在你的 PyCharm 实例中打开的所有项目中拥有相同的值。

创建新的路径变量

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

  2. 点击 添加按钮 ,输入变量的名称和值,然后点击 确定 以应用更改。

您可以使用路径变量为 外部工具 指定路径和命令行参数,并在某些 运行配置 中使用。

例如,您可以定义一个路径变量,指向某个数据源的位置(如 CSV 文件)或未存储在您项目中的 第三方库。 如果您在与项目共享的运行配置中使用此路径变量,其他人可以在其环境中为该路径变量定义正确的值,并确保该运行配置能够正常工作。

在接受路径变量的字段和配置文件中,将该变量引用为 $var_name$

PyCharm 还提供以下内置路径变量:

$USER_HOME$

当前用户的主目录。

$PROJECT_DIR$

当前项目的根目录。

创建新的路径变量

例如,您有一个 Python 脚本,用于处理存储在您系统中 reports.csv 文件中的某些数据。 您创建一个 运行/调试配置 来运行此脚本,并希望通过 VCS 与队友共享该配置。

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

  2. 点击 添加按钮 ,输入新变量的名称(例如, DATA_PATH )及其值,该值指向您磁盘上包含数据文件的目标目录。

    添加新的路径变量
  3. 通过您的版本控制系统共享该 运行/调试配置。

    运行/调试配置
  4. 查看 <项目目录>.idea/runConfiguration/<配置名称>.xml 文件:

    添加了路径变量的运行/调试配置文件

    在队友从 VCS 更新其项目后,他们会更改 DATA_PATH 变量的值,使其指向各自计算机上的数据目录。

忽略路径变量

无论何时打开或更新项目,PyCharm 都会检查是否存在未解析的路径变量。 如果 IDE 检测到任何此类变量,将会提示您为其定义值。 如果您不打算使用具有未解析路径变量的文件或目录,您可以将这些变量添加到忽略变量列表中。

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

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

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

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

2026年 3月 24日