Sublime Text构建系统本身不支持热重载,必须依赖ts-node-dev等外部监听工具驱动;因其仅一次性执行命令,无法守护进程或监听文件变更,而ts-node-dev可fork子进程并自动重启服务。

Sublime Text 的构建系统本身不支持热重载,所谓“保存即重启服务”必须靠外部监听工具(如 ts-node-dev、nodemon、livereload)驱动,构建系统只负责启动它——不是调用 node 或 ts-node,而是调用带监听能力的 wrapper。
为什么直接 ts-node $file 不会热重载
因为 ts-node 是一次性解释执行,进程启动后立即退出;改完代码保存,Sublime 并不会自动再跑一遍。构建系统默认是“执行完就结束”,没有后台守护机制。
-
ts-node-dev才是关键:它 fork 一个子进程运行你的脚本,并监听.ts文件变更,自动 kill + restart - 如果你用了路径别名(如
@/utils),光有ts-node-dev还不够,必须加-r tsconfig-paths/register - Windows 下 PowerShell 可能卡住,推荐用
"shell": true+cmd /c包裹命令
ts-node-dev 构建系统怎么写才真正生效
不能只复制网上“ts-node $file”模板。真实可用的配置要覆盖工作目录、错误定位、模块解析三要素。
-
"working_dir": "${project_path:${folder}}"必须设,否则ts-node-dev找不到tsconfig.json和package.json -
"file_regex"要匹配 TypeScript 错误格式:"file_regex": "^(.*\.ts)\((\d+),(\d+)\):\s*(.*)$",不然点击报错跳不到源码行 - Linux/macOS 示例:
"cmd": ["ts-node-dev", "--respawn", "--transpile-only", "-r", "tsconfig-paths/register", "$file"] - Windows 示例:
"cmd": ["cmd", "/c", "ts-node-dev --respawn --transpile-only -r tsconfig-paths/register "$file""]
常见报错:“Cannot find module '@/xxx'” 怎么解
这不是 Sublime 的问题,是 Node.js 启动时没加载路径映射。即使 tsconfig.json 里写了 "paths",Node 默认也看不懂 @ 别名。
- 先装依赖:
npm install --save-dev tsconfig-paths -
-r tsconfig-paths/register必须出现在ts-node-dev参数之后、入口文件之前 - 确认
tsconfig.json中"baseUrl": "."已设置,且"paths"的 key 以/结尾(如"@/*": ["src/*"]) - 建议用
npx ts-node-dev而非全局安装版,避免读不到项目本地的tsconfig-paths
真正容易被忽略的是环境一致性:Sublime 启动时的 PATH 可能和终端不一致,尤其是用 rbenv 或 nvm 管理 Node 版本时。如果构建命令里调 npx 报“command not found”,大概率是这个原因——得从已加载 shell 环境的终端里执行 subl . 启动 Sublime。

















