node命令需在系统PATH中才能直接调用，否则提示“不是内部或外部命令”；根本原因是安装时未勾选“Add to PATH”或手动配置缺失，解决方法为重装并勾选该选项，或手动添加Node.js安装路径到系统环境变量。
node 必须在系统 PATH 中，否则一键运行必然失败——这是 90% 用户首次配置失败的根源。
确认 node 命令能否在终端直接调用
不是看有没有安装 Node.js，而是看 node -v 能否在任意目录下成功返回版本号。Windows 用户尤其容易卡在这一步：安装时没勾选 “Add to PATH”，或安装的是绿色版/便携版。
- 打开命令行（CMD / PowerShell / Terminal），输入
node -v，有输出（如v20.17.0）才算通过 - 若提示
'node' is not recognized，请重装 Node.js 并确保勾选 “Add to PATH”，或手动把 Node.js 安装目录（如C:\Program Files\nodejs\）加进系统环境变量 - macOS 使用 Homebrew 安装的用户，注意是否用了
brew install node而非brew install --cask node（后者不添加 PATH）
创建最简 NodeJS.sublime-build 构建系统
别用插件封装好的“高级构建系统”，先从最原始、最可控的手动配置开始。Sublime 不会自动识别 .js 文件该用什么运行，必须显式绑定。
- 菜单栏 → Tools → Build System → New Build System…
- 清空默认内容，粘贴以下 JSON（注意是纯文本，不要带 BOM）：
{
"cmd": ["node", "$file"],
"selector": "source.js",
"file_regex": "^(...*?):([0-9]+):?([0-9]+)?:? (.*)$",
"working_dir": "$file_path"
}
- 保存为
NodeJS.sublime-build（文件名必须含.sublime-build后缀，位置默认即可） - 保存后重启 Sublime，或手动执行 Tools → Build System → NodeJS 切换过去
- 打开任意
.js文件，按Ctrl+B（Windows/Linux）或Cmd+B（macOS），输出应出现在底部面板
运行选中代码片段而不是整个文件
学习语法或测试小段逻辑时，你并不想保存成文件再运行。node -e 是唯一轻量方案，但需额外配置一个构建系统，且仅适用于无依赖、无异步等待的纯表达式。
- 新建另一个构建系统，命名为
NodeJS-Eval.sublime-build - 内容如下（关键在
"cmd": ["node", "-e", "$selected_text"]）：
{
"cmd": ["node", "-e", "$selected_text"],
"selector": "source.js",
"file_regex": "^(...*?):([0-9]+):?([0-9]+)?:? (.*)$",
"working_dir": "$file_path",
"variants": [
{
"name": "Run File",
"cmd": ["node", "$file"]
}
]
}
- 选中一段代码（如
console.log(1+2)），按Ctrl+B即可执行；若想运行整文件，可用Ctrl+Shift+B调出变体菜单选Run File - ⚠️ 注意：
node -e不支持多行语句缩进、不能读取process.stdin、无法 require 模块——它只 eval 字符串，不是 REPL
为什么 Debugger 插件或 SublimeText-Nodejs 插件常失效
它们底层仍依赖上述构建系统机制，但增加了抽象层。一旦 node 路径不对、权限受限、或插件未正确监听构建完成事件，就会表现为“点了没反应”或“输出一闪而过”。
立即学习“Java免费学习笔记（深入）”；
- SublimeText-Nodejs 插件的
Alt+R快捷键，本质就是触发一个隐藏的构建系统，若你没手动验证过基础node "$file"是否正常，插件必挂 - Debugger 插件要求项目根目录存在
.sublime-project并正确配置configurations，且只支持 Chrome DevTools 连接，不等于“点一下就断点” - 真正需要断点调试时，直接用
node --inspect-brk script.js+ Chromechrome://inspect更可靠，Sublime 只负责写和保存
working_dir）和模块解析路径的关系——比如脚本里写了 require('./utils')，但构建系统没设 "working_dir": "$file_path"，就会报 Cannot find module。这个字段不是可选项，是运行时模块加载的起点。 
