必须先确保node -v在终端可用，否则sublime任何配置均无效；因sublime启动时path继承不一致，最稳方案是构建系统中硬编码node绝对路径，并设"working_dir":"$file_path"保证模块加载正确。
node 命令必须已在终端中可用，否则 Sublime 里任何配置都无效——这是所有失败的根源。
为什么 Ctrl+B 报 “'node' is not recognized”
Sublime 启动时继承的 PATH 和你在终端里看到的往往不一致，尤其 macOS/Linux 图形界面下（Dock/Spotlight 启动），~/.zshrc 或 ~/.bash_profile 根本没加载；Windows 上则常见 Node.js 安装时没勾选 “Add to PATH”，或用了 Microsoft Store 版本（不写系统变量）。
- 先在终端运行
which node（macOS/Linux）或where node（Windows），拿到绝对路径，比如/opt/homebrew/bin/node或C:\Program Files\nodejs\node.exe - 不要依赖
"shell": true去“自动加载 PATH”——它在 macOS 上可能加载错 shell 配置，在 Windows 上反而容易卡住 - 最稳做法：构建配置里直接写死这个绝对路径，绕过所有环境变量继承问题
sublime-build 文件怎么写才真正生效
文件名必须以 .sublime-build 结尾，且保存到正确位置：Packages/User/ 目录下（macOS 是 ~/Library/Application Support/Sublime Text/Packages/User/，Windows 是 %APPDATA%\Sublime Text\Packages\User\）。
- 内容必须是合法 JSON，顶层为对象，不能有注释、尾随逗号或单引号
-
"cmd"必须是数组，例如["/usr/local/bin/node", "$file"]，不能写成字符串"node $file" -
"working_dir": "$file_path"不可省略——否则require('./utils')会因工作目录错误而报Cannot find module -
"selector": "source.js"确保只对.js文件启用该构建系统
用 nvm 或 volta 管理 Node 版本时怎么办
nvm 的本质是动态改 PATH，但 Sublime 构建进程根本不会执行 nvm use 或读取你的 shell 配置。所谓“让 Sublime 支持 nvm”，其实是让它调用 nvm 实际安装的二进制文件。
- 别写
"cmd": ["nvm", "exec", "18.18.2", "node", "$file"]——nvm命令在构建环境里大概率不存在 - 运行
nvm which 18.18.2拿到真实路径，比如~/.nvm/versions/node/v18.18.2/bin/node，然后硬编码进cmd - 每次切换 Node 版本后，必须手动更新这个路径；如果嫌麻烦，就放弃 nvm 在 Sublime 中的“自动切换”，只保证当前项目用的版本路径固定
运行带参数或需要交互的脚本为什么卡住
Sublime 的构建输出面板不支持 process.stdin，一旦脚本里有 readline 或 prompt()，就会无响应或直接退出——这不是配置问题，是机制限制。
- 传固定参数可以：把
"cmd"改成["/path/to/node", "$file", "arg1", "arg2"] - 不要尝试用
sh -c "read ..."在 macOS/Linux 上搞交互式输入——Windows 下完全失效，且跨平台不可维护 - 真正需要调试 CLI 工具？直接关掉 Sublime，去终端里跑
node script.js --help，那里才是它的主场
node 是否能执行，也不提示你当前用的是哪个 Node 版本。哪怕你配了 /usr/local/bin/node，而实际项目依赖 v20+ 的 API，它照样静默运行并抛出语法错误——你得自己确保路径指向的是正确的、兼容的二进制。Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
