Sublime Text需依赖系统已安装的Node.js，核心是确保node命令在PATH中且构建系统能调用；应先验证终端能否运行node，再配置自定义.sublime-build文件并注意路径、编码、保存等细节。
Sublime Text 本身不自带 Node.js 运行环境，也不能直接“配置 Node.js 环境”——它只是个编辑器。真正要做的，是让 Sublime 能调用系统已安装的 node 命令来执行 JS 文件。如果运行报错 node is not recognized 或 command not found: node，问题一定出在系统 PATH 或 Sublime 的构建系统路径设置上。
确认 node 命令是否能在终端/命令行中正常运行
这是最基础、也最容易被跳过的一步。Sublime 的构建系统底层调用的就是系统 shell，如果终端里都找不到 node，Sublime 肯定也找不到。
- Windows：打开 CMD 或 PowerShell，输入
where node（不是which）；确认输出类似C:\Program Files\nodejs\node.exe - macOS / Linux：在 Terminal 中运行
which node，应返回类似/usr/local/bin/node或/opt/homebrew/bin/node - 如果没输出，说明 Node.js 没装好，或安装时没勾选「Add to PATH」（Windows 安装器）、或 Homebrew 安装后未初始化 shell（macOS）
创建自定义 Node.js 构建系统（.sublime-build）
Sublime 默认没有 Node.js 构建选项，必须手动新建一个。关键点在于指定正确的 cmd 和平台适配路径（尤其是 Windows 需要 .exe 后缀）。
{
"shell_cmd": "node \"${file}\"",
"selector": "source.js",
"working_dir": "${file_path}",
"variants":
[
{
"name": "Node with args",
"shell_cmd": "node \"${file}\" ${args}"
}
]
}
-
${file}是当前打开的 JS 文件全路径；${file_path}是其所在目录，确保require()相对路径能正确解析 - Windows 用户若遇到
Unable to find command: node，可显式写绝对路径，例如："shell_cmd": "C:/Program Files/nodejs/node.exe \"${file}\""（注意正斜杠和转义） - macOS 如果用 nvm 管理 Node 版本，
which node返回的可能是~/.nvm/versions/node/v18.17.0/bin/node，但 Sublime 不展开~，需替换为完整路径如/Users/yourname/.nvm/versions/node/v18.17.0/bin/node
运行时常见错误及对应解法
即使构建系统写对了，实际运行仍可能失败，原因往往不在 Sublime 本身。
立即学习“Java免费学习笔记（深入）”；
-
Error: Cannot find module 'xxx'：说明脚本用了require('xxx')，但模块未安装。Sublime 不会自动执行npm install—— 你得先在项目根目录手动运行npm install -
SyntaxError: Unexpected token 'const'：Node.js 版本太低，不支持 ES6+ 语法。检查node -v，升级 Node 或改用 Babel 编译 - 中文路径或文件名导致乱码（Windows）：Sublime 构建系统默认编码是 UTF-8，但 cmd 默认 GBK。可在构建系统中加
"encoding": "cp936"（仅 Windows），或更稳妥地把项目移到纯英文路径下 - 保存后运行的仍是旧代码：Sublime 构建系统不会自动保存文件。务必按
Ctrl+S（Win/Linux）或Cmd+S（macOS）再运行，或启用save_on_build设置（在 Preferences → Settings 中添加"save_on_build": true）
真正的难点从来不是写那个 .sublime-build 文件，而是确保 node 命令在 Sublime 启动的子进程中可见——这取决于你的 shell 初始化逻辑、nvm/pfn 等版本管理器的 hook 是否生效、以及 Sublime 是从桌面图标还是终端启动的。后者尤其关键：从 Dock/Launcher 启动的 Sublime，通常无法继承终端里的 PATH。
