$project_path 是唯一能准确获取当前项目根目录的变量，仅当项目已保存且存在.sublime-project文件时有效；$file_path仅表示当前文件所在目录，不等于项目路径。
必须用 $project_path 变量，且仅在项目已保存、.sublime-project 文件存在时才有效；直接写死路径或依赖 $file_path 无法满足“当前项目路径”这一需求。
为什么 $file_path 不等于项目路径
$file_path 是当前打开文件所在目录的绝对路径，不是项目根目录。比如项目结构是 /home/user/myapp/，你打开了 /home/user/myapp/src/utils.py，那么 $file_path 是 /home/user/myapp/src，而非 /home/user/myapp。若构建命令需在项目根下执行（如运行 pip install -e . 或 npm run dev），用 $file_path 会导致命令找不到 setup.py 或 package.json。
无序列表呈现关键区别：
-
$project_path：仅当项目已通过Project → Save Project As…保存后才可用，值为.sublime-project所在目录的绝对路径 -
$file_path：始终可用，但仅代表当前文件所在目录，与项目无关 -
$project_path在单文件模式（未开项目）下为空字符串，此时构建系统会静默失败或报错Unable to find project path
在 .sublime-build 中正确使用 $project_path
构建系统配置中不能直接把 $project_path 当作工作目录传给 shell，Sublime 不自动展开该变量到 working_dir 字段——它只认字面量路径或空值。必须显式设置 "working_dir": "$project_path"，且该字段必须是字符串类型（不能是数组或 null）。
示例（适用于 Python 项目根下运行 python main.py）：
{
"cmd": ["python", "-u", "$project_path/main.py"],
"working_dir": "$project_path",
"selector": "source.python",
"file_regex": "^[ ]*File \"(*?)\", line ([0-9]*)"
}
注意点：
-
"working_dir": "$project_path"必须存在，否则命令默认在 Sublime 启动目录执行，非项目根 -
$project_path结尾不带斜杠，拼接子路径时要手动加，如"$project_path/src/app.py" - Windows 下路径分隔符用正斜杠
/更稳妥（Sublime 内部统一处理），避免双反斜杠转义问题 - 若项目含空格，
"shell": true不是必需项；数组形式["python", "-u", "$project_path/main.py"]已能安全处理
项目级构建系统优先于用户级构建系统
即使你已在 Packages/User/ 下配置了通用 Python 构建系统，只要项目 .sublime-project 文件中定义了 build_systems 数组，Sublime 就会优先加载项目内定义的构建系统，并忽略同名的用户级配置。
项目配置示例（编辑 .sublime-project）：
{
"folders": [
{
"path": "/home/user/myapp"
}
],
"build_systems": [
{
"name": "Run in Project Root",
"cmd": ["python", "-u", "$project_path/main.py"],
"working_dir": "$project_path",
"selector": "source.python"
}
]
}
生效前提：
- 项目必须已保存（有真实
.sublime-project文件） - 构建系统
"name"唯一，且在Tools → Build System菜单中可见 - 切换构建系统后，
Ctrl+B才调用该项目路径下的命令 - 若
build_systems数组为空或语法错误，Sublime 会回退到用户级构建系统，但$project_path仍不可用
容易被忽略的路径权限和环境隔离问题
即使 $project_path 展开正确，构建仍可能失败，常见于两类场景：
- Linux/macOS 下，
$project_path指向的目录对当前用户无执行权限（chmod +x不解决，因为 Sublime 不需要执行目录，但子命令如sh ./script.sh会因路径不可读而失败） - 项目使用虚拟环境（venv / conda），但构建系统里写的仍是系统 Python 路径；此时
$project_path正确也没用，必须把解释器路径也绑定到项目上下文，例如："cmd": ["/home/user/myapp/venv/bin/python", "-u", "$project_path/main.py"] - Windows 上若
$project_path含中文字符，某些旧版 Python 解释器（如 Python 3.7 之前）可能无法正确解码路径，建议项目路径全英文
最稳妥的做法：在项目根下放一个 run.sh（或 run.bat），构建系统只调用它，把路径逻辑和环境激活都收口到脚本里——这样 $project_path 只需确保能定位到该脚本即可。
