Sublime Text 构建系统不显示汇编错误是因为 stderr 未合并到 stdout,需在 .sublime-build 中添加 2>&1 并配置匹配汇编错误格式的 file_regex,同时确保语法 scope 与 selector 严格一致。

编译系统输出不报错,但实际失败了
Sublime Text 的 sublime-build 默认只捕获标准输出(stdout),而汇编工具链(如 ml.exe、as、gcc -c)的错误信息往往走标准错误(stderr)。结果就是:命令明明失败了(比如语法错、找不到符号),Build 面板却只显示“[Finished]”,毫无提示。
实操建议:
- 在
.sublime-build文件中显式启用"shell": true(尤其 Windows 下调用 bat/sh 脚本时必须) - 确保构建命令末尾加
2>&1(Windows)或2>&1(Linux/macOS),把 stderr 合并进 stdout,例如:"cmd": ["sh", "-c", "as $file -o ${file_base_name}.o 2>&1"] - 不要依赖
file_regex自动跳转——它只匹配 stdout 中符合正则的行;错误在 stderr 就永远不触发定位
file_regex 匹配不到错误行,光标不跳转
汇编器报错格式五花八门:ml.exe 是 Error A2008: syntax error : mov,as 是 foo.s:5: Error: invalid register,而 gcc 又带文件路径和列号。默认的 file_regex 往往只适配 C 编译器,对汇编完全失效。
实操建议:
- 先手动运行一次编译命令(如
ml foo.asm),复制真实错误行到文本编辑器,再写正则去匹配它 - 常用汇编
file_regex示例(直接粘贴进.sublime-build):"file_regex": "^(.*?):([0-9]+):?([0-9]+)?:? (Error|Warning): (.*)$"(适配gcc -x assembler或clang)"file_regex": "^([^:]+):([0-9]+): (error|warning): (.*)$"(适配 GNUas) - 正则里用非贪婪匹配
.*?,避免跨行误吞;括号必须严格对应file、line、col、error四个捕获组
Build 面板一闪而过,来不及看错误
某些构建脚本(尤其是 DOSBox 启动后立刻退出的场景)会让 Build 面板在输出完成前就关闭,错误信息被清空。用户只看到黑框闪一下,根本不知道哪错了。
实操建议:
- 在构建命令末尾加阻塞逻辑:
pause(Windows)、read -p "Press enter to continue..."(macOS/Linux) - 改用日志文件中转:
"cmd": ["sh", "-c", "as $file -o ${file_base_name}.o 2>&1 | tee build.log"],再手动打开build.log - 禁用 Sublime 的自动关闭:在用户设置中加
"show_panel_on_build": true,强制 Build 面板常驻
语法 scope 不匹配导致构建系统不触发
即使你写了 NASM.sublime-build,如果当前文件右下角显示的是 Plain Text 或 ShellScript,Sublime 根本不会考虑这个构建系统——它只检查当前语法的 selector 是否与构建定义里的 selector 字段一致。
实操建议:
- 确认当前文件语法:点击右下角文字 → 选
x86 (NASM)或x86 (GAS),不能是Assembly (NASM)(名称差一个空格或括号都不行) - 查当前语法的真实 scope:
Ctrl+Shift+P→Developer: Show Scope Name,看输出是否含source.asm.nasm或source.gas - 构建文件中的
selector必须与上一步结果严格一致,例如:"selector": "source.asm.nasm",写成source.nasm或source.asm都无效
file_regex 捕获的 Error A2006: undefined symbol : _start —— 它就静静躺在 stderr 里,等你手动加 2>&1 才肯露面。


















