Sublime构建系统报错不跳转的主因是file_regex未匹配错误输出中的文件名、行号、列号；Shell脚本报错源于权限或PATH环境变量缺失；插件print()无输出需开启Log Console Messages。
构建系统报错不跳转？file_regex 没匹配上实际输出
Sublime 的错误面板能显示文字，但双击不跳转到源码行，根本原因是 file_regex 没从错误字符串中正确抽取出「文件名、行号、列号」。它不是可有可无的字段，而是跳转功能的唯一触发条件。
常见现象：main.ts:142:5 明明在底部面板里，双击却没反应；或 Python 报错 File "utils.py", line 88 看得见，就是点不动。
- 检查当前构建系统 JSON 是否含
"file_regex"字段：菜单 → Tools → Build System → New Build System… - 根据错误格式选正则：
— 匹配index.js:23:10类型："file_regex": "^(..[^:]*):([0-9]+):([0-9]+):? ?(.*)$"
— 匹配 Python 默认格式："file_regex": "File \"([^\"]+)\", line ([0-9]+)" - 路径必须一致：如果错误里是
/home/user/proj/main.py，而你打开的是main.py（无路径），Sublime 找不到对应标签页，也不会新建文件
Shell 脚本运行报 Permission denied 或 command not found？权限与环境隔离问题
Sublime 构建系统执行 Shell 脚本时，Permission denied 和 command not found 几乎从不来自 Sublime 本身，而是 shell 权限链或环境变量断裂导致。
- Linux/macOS 下必须先
chmod +x script.sh，否则bash -c "$file"会失败 - Windows 用户若用 WSL，cmd 应写成：
["wsl", "bash", "-i", "-c", "exec \"$1\"", "_", "$file"]，别硬套bash.exe - PATH 不一致是主因：GUI 应用启动时不加载
~/.bashrc，脚本里调用的jq或自定义命令在终端能跑，Sublime 里就报错
→ 解法一：用绝对路径，如/usr/local/bin/jq
→ 解法二：改用 login shell：["bash", "-l", "-c", "$file"]
插件 print() 不输出？日志开关默认关闭
你在插件里写了 print("debug")，控制台却一片空白，不是代码没执行，而是 Sublime 默认屏蔽所有插件的输出通道。
- 先确保控制台已打开：
Ctrl + `（不是Ctrl + ~或Shift组合） - 菜单 → Tools → Developer → Log Console Messages，必须勾选它
- 勾选后，
print()、sublime.status_message()、未捕获异常的红色Traceback全部实时刷出 - 小技巧：
print()不自动换行，多条日志容易挤成一团，建议写成print("debug:", x, "\n")
看到红色 Traceback 别跳过，最后一行才是关键线索
控制台顶部突然刷出红色堆栈，不是“编辑器卡了”，而是插件在加载或运行时真实出错——这是定位问题最快的方式，比翻文档高效得多。
-
ImportError: No module named 'requests'：依赖缺失，或模块路径写错（比如目录名是utils.py却写了import Utils） -
AttributeError: 'NoneType' object has no attribute 'file_name'：view 为空却直接调用了.file_name()，没做判空 -
SyntaxError: invalid syntax：插件 Python 代码有语法错误，常发生在启动时
→ 每条Traceback最后一行都精确标出文件路径和行号，例如File "Packages/User/my_plugin.py", line 42，直接跳转就能改
