Sublime Text构建系统默认只捕获stdout,stderr被静默丢弃导致看不到报错;需通过shell重定向(如2>&1)、启用"encoding":"utf-8"、避免shell_cmd模式并使用cmd数组,才能完整显示第三方工具的错误与日志。

构建系统执行后看不到第三方工具的报错或日志?
默认情况下,Sublime Text 的 sublime-build 系统只捕获标准输出(stdout),而很多 CLI 工具(比如 eslint、prettier、tsc)会把警告和错误写到标准错误(stderr)。如果构建结果面板里“没输出”或“看似成功但实际失败”,大概率是 stderr 被静默丢弃了。
解决办法很简单:在构建系统的 JSON 配置里显式启用 quiet 为 false(默认就是 false,但某些插件或旧模板可能覆盖),并确保没加 "shell": true 以外的屏蔽逻辑。更重要的是——
-
cmd数组中避免用 shell 重定向(如2>&1),Sublime 不解析 shell 语法 - 改用
shell:true+ 命令字符串方式,才能让2>&1生效(仅限 macOS/Linux) - Windows 下需用
2^>^&1(脱字符转义),否则会被当成字面量 - 更稳妥的做法:直接让工具自身输出到
stdout,例如tsc --noEmit --pretty false或eslint --format=compact
如何让 eslint 输出同时包含 error 和 warning 到构建面板?
默认 eslint 在 CI 模式下会把 warning 当作 stdout、error 当作 stderr,而 Sublime 默认只显示 stdout。要一并捕获:
- Linux/macOS:
"cmd": ["sh", "-c", "eslint \"$1\" 2>&1", "_", "$file"] - Windows:
"cmd": ["cmd", "/c", "eslint \"%1\" 2^>^&1", "$file"] - 推荐跨平台方案:用
--format=unix(强制全走 stdout)+--quiet关闭 warning(按需) - 注意
$file在 Windows 下路径含空格时必须用双引号包裹,否则命令截断
构建系统里怎么拿到 exit code 并高亮失败?
Sublime 不暴露原始 exit code 给用户界面,但构建面板顶部状态栏会显示 [Finished in Xs with exit code Y] —— 这个 Y 就是真实退出码。关键点在于:
- 只要命令返回非 0,构建面板自动标红,无需额外配置
- 若工具总返回 0(比如某些包装脚本忽略子进程 exit code),必须修复脚本:末尾加
exit $? - Python 类工具可用
sys.exit(1)显式控制;Node.js 用process.exit(1) - 不要依赖
result = os.system(...),它在 Windows 上高位被截断,应改用subprocess.run(...).returncode
为什么 build 结果面板里中文乱码(尤其 Windows)?
根本原因是 Sublime 默认用系统 locale 解码子进程输出,而 cmd/powershell 默认是 GBK,但 Sublime 内部按 UTF-8 处理。常见现象是 替代汉字,或整行消失。
- 临时解法:在构建系统里加
"encoding": "GB2312"(仅 Windows cmd) - 根治方法:启动 cmd 时加
chcp 65001(切换 UTF-8),再运行工具(需工具本身支持 UTF-8 输出) - PowerShell 更可靠:
"cmd": ["powershell", "-Command", "chcp 65001; eslint '$file'"] - VS Code 用户常迁移到 Sublime 后忽略这点,因为 VS Code 自动处理了编码协商
构建系统不是黑盒,它的输出管道非常透明——只是默认没打开 stderr 和编码协商。真正卡住人的,往往是一行没加的 2>&1,或一个没设的 "encoding" 字段。











