$file变量为空或报错是因为Sublime Build System不读内存内容，仅在文件已保存时展开为绝对路径；未保存文件（Untitled）中该变量为空字符串，导致命令如["python", ""]执行失败，这是硬性限制，非配置问题。
为什么 $file 变量总为空或报错
因为 Sublime 的构建变量不读内存，只认磁盘路径。如果文件没保存过（标签页显示 Untitled），$file 就是空字符串，命令变成类似 python -u ""，直接失败或静默退出。这不是配置问题，而是硬性限制。
实操建议：
- 执行构建前务必先保存文件（
Ctrl+S或Cmd+S），哪怕临时存到桌面 -
$file_base_name、$file_path、$file_name同样依赖已保存状态，未命名时全部失效 - 没有
$file_content这种变量——Build System 不访问编辑器内存内容，别浪费时间找
常用文件名变量怎么用、有什么区别
$file 是最常用也最安全的变量，它展开为当前文件的绝对路径（如 /home/user/script.py）。其他变量只是它的切片，不能嵌套或运算。
常见组合与注意事项：
-
$file：全路径，适合直接传给解释器（["python", "$file"]） -
$file_path：目录部分（不含文件名），常用于设"working_dir": "$file_path"，让命令在项目根目录运行 -
$file_name：带扩展名的文件名（如main.py），适合日志或输出重命名 -
$file_base_name：不带扩展名（如main），可用于生成同名可执行文件（gcc "$file" -o "$file_base_name"） - 所有变量都是字面字符串拼接，
"$file_path/.."不会向上跳目录，就是原样输出
Windows 路径含空格时，$file 会引发什么问题
问题不在 $file 本身，而在于你如何用它。如果 cmd 字段写成字符串（如 "cmd": "python -u $file"），Sublime 会把整个命令丢给 shell 解析，而 Windows 对空格极其敏感——$file 展开后若路径含空格（如 C:My Scripts est.py），shell 会截断成 C:My，后续报错 Unable to find command Scripts est.py。
正确做法是用数组 + -u：
- Windows：
"cmd": ["C:\Program Files\Python312\python.exe", "-u", "$file"]（注意双反斜杠和引号包裹每个数组元素） - macOS/Linux：
"cmd": ["python3", "-u", "$file"]（前提是which python3返回路径正确） - 永远别用
shell_cmd处理$file，除非你明确需要 shell 功能（如管道、重定向），否则跨平台性和稳定性都更差
selector 匹配不上，$file 再对也没用
$file 能展开，不代表构建系统会被自动选中。Sublime 是靠右下角显示的 syntax scope（不是文件扩展名）来匹配 selector 的。比如 Python 文件的 scope 是 source.python，不是 .py；Shell 脚本是 source.shell，不是 .sh。
排查方法：
- 打开目标文件，按
Ctrl+Shift+P（Windows）或Cmd+Shift+P（macOS），输入Inspect Scope，看光标处实际 scope - 常见 scope 值：
source.python、source.js、source.c、source.shell - 想“万能运行”任意文本文件，可用
"selector": "source | text"，但要配合shell_cmd和后缀判断脚本，否则可能误跑二进制文件
变量本身没玄学，真正卡住人的永远是路径、scope 和保存状态这三个点——尤其 $file 为空这件事，90% 的人第一次都会栽。
