“一键启动项目”不能只靠cmd写死命令，因为Sublime构建系统仅执行单次命令、不维护进程生命周期、不处理环境变量/端口检测/热重载等服务依赖，且cmd数组不支持后台运行（&）和复杂shell操作；应改用shell_cmd字符串配合&、source/call激活环境、-u无缓冲及working_dir等配置。
为什么“一键启动项目”不能只靠 cmd 写死一个命令
Sublime 的构建系统本质是调用 shell 执行单条命令或简单管道，它不维护进程生命周期、不复用终端、也不自动处理依赖安装或服务监听。所谓“启动项目”，比如跑一个 Flask 服务、启动 Vue 开发服务器、或执行 npm run dev，背后往往涉及：环境变量加载、工作目录切换、端口占用检测、后台守护、热重载监听——这些 Sublime 都不干。直接写 "cmd": ["npm", "run", "dev"] 看似能跑，但输出卡住、Ctrl+C 不生效、改代码没反应，全是常态。
shell_cmd 比 cmd 更适合启动长期运行的服务
cmd 是数组形式，适合短命命令（如编译、单次脚本）；shell_cmd 是字符串，由系统 shell 解析，能支持 &&、|、; 和后台符号 &，更适合启动服务类任务。
- 想让服务在后台跑起来且不阻塞构建面板？加
&："shell_cmd": "npm run dev &" - 需要先激活虚拟环境再启动？写成一行：
"shell_cmd": "source venv/bin/activate && python app.py"（macOS/Linux） - Windows 用户注意：
shell_cmd在 Windows 上走cmd.exe，用call激活 conda 环境："shell_cmd": "call conda activate myenv && python app.py" - 别忘了设
"working_dir": "$file_path"，否则package.json或requirements.txt很可能找不到
输出不刷新、Ctrl+B 卡死？关键在缓冲和信号传递
Node.js、Python 的 stdout 默认行缓冲，而 Sublime 构建系统不是伪终端（pty），导致 console.log("starting...") 或 print("Serving on http://127.0.0.1:5000") 一直不显示，直到进程退出。更糟的是，你按 Ctrl+Break 或 Ctrl+C，信号根本传不到子进程。
- Node.js 项目优先用：
"shell_cmd": "node --unhandled-rejections=warn -u $file"（-u强制无缓冲） - Python Web 项目（Flask/Django）推荐：
"shell_cmd": "python -u -m flask run --port=5000 2>&1"，2>&1合并 stderr，避免错误被吞 - 终极兜底：用 shell 包一层，把输出转为行导向流：
"shell_cmd": "sh -c 'npm run dev 2>&1 | stdbuf -oL cat'"（需系统装stdbuf）
如何让构建系统自动识别项目类型，而不是手动切
Sublime 不会根据文件夹结构自动选构建系统，它只看当前文件的语法（selector）或你手动指定的默认项。一个前端项目里既有 .js 又有 .py，你不可能每次切文件都去点 Tools → Build System → VueDev。
- 给项目根目录放一个空文件，比如
.sublime-project，内容加：{ "build_systems": [ { "name": "Vue Dev Server", "shell_cmd": "npm run dev", "working_dir": "${project_path}", "selector": "source.js" } ] } - 或者用
"selector": "source.json"+ 文件名匹配，比如只对package.json生效："file_regex": "^package\.json$"（不常用，但有效） - 最实用的办法：把构建系统文件命名为
ProjectStart.sublime-build，不设selector，然后靠快捷键绑定——在Preferences → Key Bindings里加：[{"keys": ["ctrl+alt+r"], "command": "build", "args": {"build_system": "ProjectStart"}}]
真正容易被忽略的，是构建系统一旦出错（比如 JSON 少了个逗号），整个 Packages/User/ 目录下的构建系统都会失效，而且 Sublime 不报错——它只是默默回到“No build system”状态。每次改完配置，先丢到 jsonlint.com 过一遍，比反复重启省十分钟。
