PyCharm 2025.1 Help

路径变量

使用路径变量来定义绝对路径,以便访问不属于特定项目的资源。 这些外部资源可能位于您队友的计算机上的不同位置。 这就是为什么用户定义的自定义路径变量不会存储为 项目设置 ,而是存储为 全局 IDE 设置。 一旦配置,这些路径变量将在您使用 PyCharm 打开的任何项目中具有相同的值。

创建新的路径变量

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

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

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

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

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

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

$USER_HOME$

当前用户的主目录。

$PROJECT_DIR$

当前项目的根目录。

创建新的路径变量

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

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

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

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

    运行/调试配置
  4. 检查 <project directory>.idea/runConfiguration/<configuration name>.xml 文件:

    包含路径变量的运行/调试配置文件

    在您的团队成员从 VCS 更新其项目后,他们将更改 DATA_PATH 变量值,使其指向其计算机上的数据目录。

忽略路径变量

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

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

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

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

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

最后修改日期: 2025年 4月 23日