Sublime构建系统常用变量包括：$file获取当前文件完整路径，$file_path获取文件所在目录，$file_name返回文件名含扩展名，$file_basename去除扩展名，$file_extension提取带点扩展名，$project返回项目文件路径，$project_path提供项目目录，$project_name获取项目名称不含扩展名，$packages指向插件目录，适用于各类构建与路径处理场景。

如果您在配置Sublime Text的构建系统时需要引用文件或路径信息，但不清楚可用的环境变量，可能会导致命令执行失败或路径错误。以下是Sublime构建系统中常用的文件与路径变量及其详细说明：

一、$file

该变量用于获取当前打开并处于活动状态的完整文件路径，包含文件名和扩展名。它适用于需要对当前编辑文件进行操作的构建任务。

1、替换为当前文件的绝对路径，例如：/Users/name/project/main.py。

2、常用于编译或运行单个源文件的场景，如Python脚本执行或C++编译。

二、$file_path

表示当前文件所在的目录路径，不包括文件名本身。适合需要在文件所在目录下执行命令的情况。

1、替换为目录的绝对路径，例如：/Users/name/project。

2、可用于调用本地工具链或读取同目录下的依赖资源。

三、$file_name

仅返回当前文件的完整名称，包含扩展名，但不包含任何路径信息。适用于输出提示或日志记录。

1、替换为文件名字符串，例如：main.cpp。

2、可在构建输出中显示处理的具体文件名称。

四、$file_basename

获取当前文件的名称部分，去除扩展名，便于生成中间文件或目标文件名。

1、替换为无扩展名的文件名，例如：main。

2、常用于命名编译后的可执行文件或临时输出文件。

五、$file_extension

仅提取当前文件的扩展名，包含前导点号，用于判断文件类型以决定处理方式。

1、替换为带点的扩展名，例如：.py 或 .html。

Sudowrite

对用户最友好的AI写作工具

66

查看详情

2、可用于条件判断逻辑中区分不同语言的构建流程。

六、$project

返回当前加载项目的完整JSON文件路径，仅在项目已保存且被加载时有效。

1、替换为项目文件的绝对路径，例如：/Users/name/project.code-workspace。

2、适用于基于项目配置执行特定构建流程的场景。

七、$project_path

提供当前项目文件所在的目录路径，若未打开项目则为空值。

1、替换为项目文件所在目录，例如：/Users/name。

2、可用于定位项目级配置文件或工具脚本的位置。

八、$project_name

获取当前项目文件的名称（不含扩展名），便于在构建输出中标注所属项目。

1、替换为项目文件名主体，例如：project。

2、适用于多项目环境中标识构建来源。

九、$packages

指向Sublime Text安装目录下的Packages文件夹，用于访问插件或语法定义资源。

1、替换为插件目录路径，例如：/applications/Sublime Text.app/Contents/MacOS/Packages。

2、可用于调试自定义构建系统或包开发。