Sublime配置Node.js环境需手动创建.sublime-build文件，硬编码node绝对路径、设"working_dir":"$file_path"、"selector":"source.js"，禁用nvm动态切换，因Sublime不继承shell的PATH。
Sublime 本身不带 Node.js 运行时，所谓“配置环境”就是让它能调用你系统里已装好的 node 命令——如果终端里都跑不了 node -v，Sublime 一定失败，别往下试了。
为什么 Ctrl+B 报 “'node' is not recognized”
根本原因是 Sublime 启动时没继承到你 shell 配置里的 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，不能有注释、尾随逗号或单引号。
使用固定的 Next.js/Tailwind/Prisma 技术栈构建并记录独立 SaaS 项目，仅将 FastAPI 用于 Python 工作负载，并遵循严格的架构规范。
-
"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 或类似交互逻辑，会卡住或直接退出——这不是配置问题，是机制限制。
- 调试 CLI 工具请切回终端，别在 Sublime 里硬扛
- 想传参？临时改
cmd字段，比如["/usr/local/bin/node", "$file", "arg1", "arg2"] - 中文路径或输出乱码？加
"encoding": "UTF-8"（Sublime 4+ 基本默认 OK，老版本需手动加）
真正容易被忽略的点是：$file 和 $file_path 的语义差异——用错一个，require() 就崩；还有 nvm 用户常以为“终端能用，Sublime 就该能用”，结果掉进 PATH 继承黑洞里出不来。
