Sublime Text 通过 Build System 运行 Node.js 脚本，核心是调用系统 node 命令；需先确保 node -v 在终端可用，再手动创建 Node.sublime-build 文件配置 cmd、working_dir 等参数，避免插件依赖。
Sublime Text 里直接运行 Node.js 脚本，靠的是 Build System，不是插件也不是启动器
Sublime Text 本身不内置 Node.js 运行能力，它靠 Build System 把当前文件交给系统命令执行。你看到的“NodeJS”插件（比如 Nodejs 插件）只是帮你预置了这个 Build System，并加了些快捷键和输出重定向——但核心逻辑没变：它最终调用的还是你本地装的 node 命令。
所以第一步不是搜插件，而是确认：node 在终端能运行吗？打开命令行输 node -v，有输出才继续。
- 如果报错
command not found: node，说明 Node.js 没加进系统 PATH，Sublime 就找不到它 —— 即便你双击安装了 Node.js，macOS 和 Windows 都可能漏掉这步 - Windows 用户尤其注意：用 Chocolatey 或 Scoop 安装的 Node.js，PATH 通常没问题；但用官网 .msi 安装时，勾选 “Add to PATH” 才生效
- macOS 用 Homebrew 装的
node，默认在/opt/homebrew/bin/node（Apple Silicon）或/usr/local/bin/node（Intel），但 Sublime 启动方式（比如从 Dock 点开）可能不继承 shell 的 PATH，导致找不到node
手动配置 Build System：比装插件更稳、更透明
与其依赖第三方插件（比如已停止维护的 Nodejs 插件），不如自己建一个 .sublime-build 文件。它本质就是一个 JSON，告诉 Sublime：“用什么命令、带什么参数、在哪工作目录下跑”。
路径：菜单栏 Tools → Build System → New Build System…，粘贴以下内容后保存为 Node.sublime-build：
{
"cmd": ["node", "$file"],
"selector": "source.js",
"shell": true,
"working_dir": "$file_path"
}
-
cmd是核心：必须写成数组形式，["node", "$file"]表示执行node /path/to/current/file.js；别写成"node $file"字符串，Windows 下会出错 -
shell设为true才能正确解析$file变量；设为false时变量不展开，直接报错Cannot find module '/path/to/$file' -
working_dir很关键：不设的话，require('./config.json')这类相对路径会从 Sublime 安装目录开始找，而不是你的项目目录 - 保存后，用快捷键
Ctrl+B（Win/Linux）或Cmd+B（macOS）就能运行当前 JS 文件
常见错误：明明写了 console.log，输出面板却空着或一闪而过
这不是 Sublime 的 bug，是 Node.js 进程退出太快，或者 Build System 没捕获 stdout/stderr。
- 输出面板为空？先检查 Build System 是否被正确选中：右下角状态栏看是否显示
Node；没显示就去 Tools → Build System 手动选一下 - 输出一闪而过？大概率脚本执行完立刻退出，面板自动关闭。解决办法：在脚本末尾加一句
process.stdin.resume()（仅调试用），或改用node --inspect-brk配合 Chrome DevTools - 报错
Error: Cannot find module 'xxx'？90% 是因为working_dir没设对，导致node_modules找不到。确认working_dir是"$file_path"，不是"."或留空 - 中文乱码（Windows）？在
.sublime-build里加一行："encoding": "cp936"（GBK）或"utf-8"，视控制台默认编码而定
想传参数给 Node 脚本？Build System 支持变量，但别硬编码
比如你想运行 node index.js --port 3000 --env dev，不能把参数写死在 cmd 里，否则每次都要改配置。用 args 字段 + 输入框更灵活：
{
"cmd": ["node", "$file", "$args"],
"selector": "source.js",
"shell": true,
"working_dir": "$file_path"
}
- 保存后，按
Ctrl+Shift+B（Win/Linux）或Cmd+Shift+B（macOS），会弹出输入框，输入--port 3000 --env dev即可 -
$args是 Sublime 内置变量，只在该次构建中生效，不影响其他文件 - 注意空格分隔，不要写成
"--port=3000"—— Node.js 原生解析不认等号形式，除非你自己在脚本里处理 - 如果参数含空格（比如
--name "my app"），Sublime 会自动加引号，不用手动处理
复杂点在于环境变量和多版本 Node 切换——那些得靠 shell wrapper 或 nvm 配合，Sublime 的 Build System 本身不处理这些。真要隔离环境，不如在终端里跑 nvm use 18 && node index.js，再把 Sublime 当纯编辑器用。
