路径变量
路径变量是绝对文件系统路径的占位符。 它们允许你用命名变量替换硬编码的绝对路径。 这样可以使项目配置在不同的计算机之间可移植。
由于此类资源可能在每位开发者的计算机上位于不同的位置,用户自定义的路径变量会作为 全局 IDE 设置而不是 项目设置进行存储。 项目只存储变量名称,每位开发者在本地定义其值。 配置完成后,路径变量在您当前 WebStorm 实例打开的所有项目中拥有相同的值。
创建新的路径变量
按下 Ctrl+Alt+S 打开设置,然后选择 。
点击
,输入变量的名称和值,然后点击 确定 以应用更改。
您可以使用路径变量来为 外部工具和某些 运行配置指定路径和命令行参数。 有关更多信息,请参阅 内置 IDE 宏。
例如,您可以定义一个路径变量,指向某些数据源(如 CSV 文件)或未存储在项目中的 第三方库的位置。 如果您在与项目共享的运行配置中使用此路径变量,其他人可以在其环境中定义此路径变量的正确值,并确保运行配置对他们有效。
请在接受路径变量的字段和配置文件中将变量称为 $var_name$。
WebStorm 还具有以下内置路径变量:
- $USER_HOME$
当前用户的主目录。
- $PROJECT_DIR$
当前项目的根目录。
忽略路径变量
每当您打开或更新项目时,WebStorm 会检查未解决的路径变量。 如果 IDE 检测到任何内容,它会要求您为其定义值。 如果您不打算使用包含未解析路径变量的文件或目录,您可以将它们添加到忽略变量列表中。
您还可以使用忽略变量列表,当传递给 run/debug 配置的程序参数与路径变量(例如,环境变量)格式相同时。
按下 Ctrl+Alt+S 打开设置,然后选择 。
向 忽略的变量 字段添加 WebStorm 不应视为路径变量的名称。
点击 确定 以应用更改。
2026年 3月 24日