Sublime Text需依赖系统Node.js环境，核心是确保终端中node -v可运行；若失败则需配置PATH，再创建自定义.sublime-build文件调用node执行JS文件。
Sublime Text 本身不自带 Node.js 运行环境，也不能直接“配置 Node.js 环境”——它只是个编辑器。真正要做的，是让 Sublime 能调用系统已安装的 node 命令来执行 JS 文件。如果运行时报错 node is not recognized 或 command not found: node，问题一定出在系统 PATH 没把 Node.js 可执行路径包含进去，而不是 Sublime 设置没调对。
确认 node 命令能否在终端/命令行中直接运行
这是最关键的前置步骤。Sublime 的构建系统（Build System）本质就是调用 shell 命令，如果终端里都跑不起来 node，Sublime 肯定也跑不起来。
- 打开系统终端（macOS/Linux：Terminal；Windows：CMD 或 PowerShell）
- 输入
node -v和npm -v，确认有输出版本号 - 如果没有，说明 Node.js 没装，或装了但没加进 PATH：
- macOS Homebrew 安装的通常在
/opt/homebrew/bin（Apple Silicon）或/usr/local/bin - Windows 默认可能在
C:\Program Files\nodejs\，需手动添加到系统环境变量 PATH
- macOS Homebrew 安装的通常在
为 Sublime 创建一个可用的 Node.js 构建系统
Sublime 通过 .sublime-build 文件定义如何运行代码。默认的 “JavaScript” 构建系统只做语法检查，不执行；必须新建一个专用于 node 的。
- 菜单栏选择 Tools → Build System → New Build System…
- 替换全部内容为以下 JSON（注意
shell_cmd行）：
{
"shell_cmd": "node \"${file}\"",
"selector": "source.js",
"file_regex": "^[ ]*File \"(...*?)\", line ([0-9]*)",
"working_dir": "${file_path}",
"encoding": "utf-8"
}
- 保存为
NodeJS.sublime-build（文件名任意，但后缀必须是.sublime-build） - 之后在 Tools → Build System 下就能选中它
-
${file}是当前打开的 JS 文件全路径，${file_path}让node在文件所在目录下运行（避免模块解析失败）
运行 JS 文件时常见报错及应对
即使构建系统写对了，实际运行仍可能失败，原因往往和 JS 代码本身或 Node 环境有关：
-
Error: Cannot find module 'xxx'：说明用了require('xxx')但没装包，或没在项目根目录运行（node_modules不在当前工作目录下） -
SyntaxError: Unexpected token '...'：Node 版本太低，不支持你写的 ES2018+ 语法（比如可选链、top-level await），查node -v，升级 Node - 中文路径报错（Windows 尤其常见）：
node对非 ASCII 路径支持不稳定，把文件移到纯英文路径下再试 - 构建后没反应、光标卡住：JS 代码里有
while(true)或没结束的readline，导致进程不退出 —— Sublime 默认会等进程结束才显示输出
不需要插件，但可以加点实用小优化
原生 Sublime + 上述构建系统已足够日常调试简单脚本。如果想更顺手，可手动加两处：
- 在构建系统 JSON 中增加
"variants"支持带参数运行（比如node script.js --port 3000）：
{
"shell_cmd": "node \"${file}\" $1 $2 $3 $4 $5",
"selector": "source.js",
"working_dir": "${file_path}",
"variants":
[
{
"name": "Run with args",
"shell_cmd": "node \"${file}\" $1 $2 $3 $4 $5"
}
]
}
- 按
Ctrl+Shift+B（Windows/Linux）或Cmd+Shift+B（macOS）可唤出构建命令面板，选 “Run with args”，再输入参数 - 注意：Sublime 不提供交互式 stdin 输入（比如
prompt()或readline的输入框），这类脚本建议直接切到终端运行
真正卡住人的从来不是 Sublime 设置，而是 node 命令是否就绪、路径是否干净、Node 版本是否匹配代码语法。把终端里的 node -v 和 node xxx.js 先跑通，Sublime 那边基本就不会出意外。
