GoLand 2026.1 Help

路径变量

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

由于这些资源在每个开发者的计算机上可能位于不同的位置,用户自定义的路径变量会作为 全局 IDE 设置而不是 项目设置进行存储。 项目只存储变量名,每位开发者在本地定义其值。 配置完成后,路径变量在你当前的 GoLand 下打开的所有项目中都具有相同的值。

创建新的路径变量

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

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

您可以使用路径变量来为 外部工具和某些 运行配置指定路径和命令行参数。 如需更多信息,请参阅 内置 IDE 宏

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

另一个示例是为您在项目中使用的 附加目录定义路径变量。 在另一台计算机上,该目录可能存储在不同的位置。 为了确保包含附加目录的项目可以在另一台计算机上共享和使用,请使用路径变量定义附加目录的位置。

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

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

$USER_HOME$

当前用户的主目录。

$PROJECT_DIR$

当前项目的根目录。

忽略路径变量

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

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

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

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

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

示例:创建一个新的路径变量

您可能有一个位于项目目录之外的附加目录。 此目录已附加到您的项目中,并且该目录的路径包含在项目的 .iml 文件中。 然而,此路径不应是绝对路径,因为该目录的位置在其他计算机上可能不同。 在这种情况下,您可以创建 PATH_TO_ATT_DIR 变量:

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

  2. 点击 添加按钮

  3. 添加变量 对话框中,输入 PATH_TO_ATT_DIR 变量及其指向磁盘上目录位置的值。

  4. 通过您的版本控制系统共享 .iml 文件。

  5. 在您的团队成员从 VCS 更新他们的项目后,他们将更改 PATH_TO_ATT_DIR 变量值,使其指向他们计算机上的库位置。

2026年 3月 26日