Sublime构建系统中需用${project_path}获取项目根目录，但仅当通过Open Folder打开项目、构建系统被显式启用且置于Packages/User/下时才有效；否则为空，须避免误用$file_path。
构建系统里怎么拿到项目根目录
Sublime 的构建系统默认不暴露项目路径，$file 只能拿到当前文件的绝对路径，$file_path 是其父目录，但都不是项目根目录。真要调用项目目录，得靠 ${project_path} 变量——它只在项目已加载（即通过 File → Open Folder… 或拖拽文件夹打开）且构建系统被项目显式指定时才有效。
-
${project_path}在未加载项目时为空字符串，命令执行会失败或静默退出 - 必须在项目设置中显式启用该构建系统：打开 Project → Edit Project，在
settings里加"build_system": "YourBuildSystem"，或手动选中该构建系统（Tools → Build System → YourBuildSystem） - 若项目含多个文件夹（Add Folder to Project…），
${project_path}指的是第一个添加的根路径，不是“最外层”统一根目录
为什么 $file_path 不等于项目目录
因为 $file_path 是当前文件所在目录，而项目目录是用户通过 Open Folder… 指定的顶层路径。两者可能差好几层——比如项目根是 /work/myapp，你编辑的是 /work/myapp/src/utils/helper.py，那 $file_path 就是 /work/myapp/src/utils，不是 /work/myapp。
- 常见误用：用
"working_dir": "$file_path"期望运行在项目根下，结果命令在子目录执行，找不到package.json或requirements.txt - 正确做法：显式设
"working_dir": "${project_path}"，并确保项目已加载、构建系统已激活 - Windows 下路径含空格时，
${project_path}会展开为带空格的字符串，必须配合"shell": true或数组形式 + 引号包裹，否则 cmd 解析失败
${project_path} 失效的典型场景
变量为空不是配置写错了，而是环境没满足。最常踩的三个坑：
- 用 File → Open… 打开单个文件，而非 Open Folder… —— 这种方式根本没建立项目，
${project_path}必然为空 - 双击文件夹启动 Sublime：Windows/macOS 默认单实例，后启动的会覆盖前一个项目，
${project_path}指向最后那个 - 构建系统放在
Packages/MyLang/而非Packages/User/—— 文件不被加载，变量自然不参与替换
没有项目时的替代方案
如果只是临时跑脚本、不想建项目，又需要“类似项目根”的路径，只能退而求其次：
- 用
$file_path向上遍历：比如 Python 构建中写["python", "-c", "import os; print(os.path.abspath(os.path.join('$file_path', '..')))，再用 shell 脚本解析输出（不推荐，跨平台难） - 硬编码路径：仅限本地固定开发环境，如
"working_dir": "/Users/me/work/myapp"，但无法共享给团队 - 配合插件：如 ProjectManager 或自定义 Python 插件监听
on_load事件推导项目根，再写入临时变量——复杂度远超需求本身
${project_path} 就只是个字符串。 
