file_regex是唯一能提取行号的字段,Sublime必须依赖它从构建输出中正则提取“文件名、行号、列号”三元组,未配置则双击错误行无法跳转;其值须与错误输出逐字匹配,如Python用"File \"(1+)\", line ([0-9]+)",gcc用"^(2):([0-9]+):([0-9]+):? ?(.)$"。\" ↩: ↩

file_regex 是唯一能提取行号的字段
Sublime 不会自动从构建输出里“猜”哪一行是错误位置,必须靠 file_regex 字段用正则把「文件名、行号、列号」三元组抽出来。没配这个字段,双击错误行永远不跳转,控制台再详细也没用。
常见错误现象:main.py:24:5: SyntaxError: invalid syntax 显示在底部面板,但双击无反应;或只显示 File "utils.py", line 137 却跳不到对应标签页。
-
file_regex值必须和实际错误输出**逐字匹配**——比如 Python 报错带引号,正则里就得有";C++ 的 clang 输出含列号,正则就得捕获第三个分组 - Windows 路径里的反斜杠要双写:
"file_regex": "File \"([^\"]+)\", line ([0-9]+)"✅,"File "C:\test.py", line ([0-9]+)"❌(未转义) - 如果报错里路径是绝对路径(如
/home/user/proj/main.py),而你打开的是main.py(没带路径),Sublime 找不到已打开的 tab,也不会新建文件
Python 构建系统推荐 file_regex 写法
Python 默认报错格式稳定,但不同环境(标准 CPython、Anaconda、PyPy)可能微调空格或引号。下面两个正则覆盖绝大多数情况:
-
"file_regex": "File \"([^\"]+)\", line ([0-9]+)"—— 匹配File "main.py", line 42这类标准格式 -
"file_regex": "^[ ]*File \"([^\"]+)\", line ([0-9]+)"—— 加了行首空格容错,适配 pipenv 或某些 wrapper 工具的输出缩进
别用模糊写法,比如 "file_regex": "line ([0-9]+)" —— 它会把所有含 line 123 的文本都当错误行,包括注释或日志。
gcc / clang 构建系统怎么写 file_regex
C/C++ 编译器输出通常带文件路径、行号、列号和消息,例如:src/main.c:15:10: error: 'x' undeclared。这时 file_regex 必须捕获全部三个位置:
-
"file_regex": "^(..[^:]*):([0-9]+):([0-9]+):? ?(.*)$"—— 第一组捕获文件路径(支持相对/绝对),第二组行号,第三组列号 - 注意开头
^..是为了跳过 ANSI 颜色码(如\x1b[31m),否则正则会匹配失败 - 如果你用的是 MinGW 或旧版 gcc,可能不输出列号,那就把第三组去掉,改成
"^(..[^:]*):([0-9]+):? ?(.*)$"
验证方法:手动在终端跑 gcc -c main.c 2>&1,复制完整输出,粘贴到 regex101.com 测试是否能正确分组。
为什么改了 file_regex 还不跳转?检查这三点
正则写对了,但双击仍无效,问题往往不在正则本身,而在加载链路上:
- 构建系统文件没保存在正确路径:
Packages/User/目录下,且文件名是Python.sublime-build(不是python.sublime-build或MyBuild.sublime-build) - JSON 格式非法:含注释
//、末尾多逗号、编码不是 UTF-8 无 BOM(尤其 Windows 记事本另存时容易中招) - 当前文件语法 scope 不匹配
selector字段:右下角状态栏显示的是Python,但你的构建系统写了"selector": "source.python.anaconda",就得同步改 selector 或换回原生语法高亮
最隐蔽的问题是 Sublime 没真正加载新配置——改完必须完全退出(包括托盘进程),再重启,否则它还在用缓存的老版本。

















