Sublime Text调用Node.js需确保终端中node -v可运行，否则报“command not found”；应使用cmd字段而非shell_cmd，显式配置"working_dir": "$file_path"和"encoding": "utf-8"解决路径与中文乱码问题。
Sublime Text 本身不运行 Node.js，它只调用你系统里装好的 node 命令——如果终端里 node -v 都报错，Sublime 就一定跑不起来。
为什么 Ctrl+B 报 “node is not recognized” 或 “command not found”
这不是 Sublime 的 bug，而是它在图形界面下启动时没继承 shell 的 PATH。macOS/Linux 尤其明显；Windows 上则常因 Node.js 没进系统环境变量，或安装的是便携版、nvm 管理的版本但未激活。
- 先打开终端（不是 Sublime 内置的 console），执行
which node（macOS/Linux）或where node（Windows），拿到绝对路径，比如/usr/local/bin/node或C:\Program Files\nodejs\node.exe - 别信“自动检测 PATH”，GUI 启动的 Sublime 基本不可靠
- 如果你用
nvm，确保当前 shell 里node -v返回的是你想要的版本；"shell": true能帮它加载~/.zshrc，但前提是 Sublime 是从该 shell 启动的（比如终端里运行subl）
构建系统里 cmd 和 shell_cmd 怎么选
必须用 cmd 字段，不能用 shell_cmd——否则 "encoding": "utf-8" 会失效，中文输出直接乱码。
-
"cmd": ["node", "$file"]：推荐方式，支持encoding、working_dir等关键字段 -
"shell_cmd": "node \"$file\""：看起来简洁，但 Sublime 不会按你设的encoding解码输出，Windows 下大概率中文变问号 - Windows 用户若确定
node已进系统 PATH，可设"shell": false；macOS/Linux 建议保留"shell": true，尤其用了nvm或asdf
working_dir 为什么必须设成 "$file_path"
不设这个，require('./utils')、fs.readFile('./config.json') 这类相对路径全都会失败——因为 Node.js 默认工作目录是 Sublime 的安装路径或用户主目录，不是你的 JS 文件所在目录。
-
"working_dir": "$file_path"让node启动时自动 cd 到文件所在目录 - 注意：
$file_path结尾不含斜杠，但 Node.js 的require和fs能正确识别 - 如果你的脚本依赖
process.cwd()，这个设置就更关键了
中文输出乱码？只差一个 "encoding": "utf-8"
Sublime 控制台默认用系统 locale 解码子进程输出（Windows 是 GBK），而 Node.js 默认 UTF-8 输出，两者不匹配就乱码。改文件编码、改状态栏显示都没用。
- 必须在构建配置里显式写
"encoding": "utf-8" - 必须配合
"cmd"字段使用，"shell_cmd"下该字段被忽略 - Node.js 本身不需要额外参数（不像 Python 需要
-u），但确保你的 JS 文件保存为无 BOM 的 UTF-8 格式
最稳的配置就是硬编码 node 绝对路径 + "cmd" + "working_dir": "$file_path" + "encoding": "utf-8"——看似啰嗦，但它绕开了所有 shell 环境继承问题、编码协商问题和相对路径解析问题。很多人卡在第一步：没验证终端里 node -v 是否真能跑，就急着配 Sublime，结果反复折腾构建文件却始终失败。
