Sublime Text需配置外部构建系统调用tsc编译TypeScript；常见失败原因是tsc未正确安装或PATH配置不当、tsconfig.json缺失或路径错误、working_dir未指向项目根目录导致无法读取配置。
Sublime Text 本身不支持 TypeScript 编译，必须借助外部构建系统（Build System）调用 tsc 命令；配置失败的常见原因不是 Sublime 设置错了，而是 tsc 没装好、没在 PATH 里，或 tsconfig.json 路径不对。
确认全局安装了 tsc 并能被 Sublime 调用
Sublime 的构建系统默认使用系统 PATH 查找命令，如果 tsc 是通过 npm install -g typescript 安装的，但终端能运行、Sublime 却报 'tsc' is not recognized 或 command not found，大概率是 Shell 环境和 GUI 应用环境 PATH 不一致（尤其 macOS 和 Linux）。
- macOS：在
~/.zshrc（或~/.bash_profile）中确保export PATH="/usr/local/bin:$PATH"存在，且 Node/npm 全局 bin 路径（如$(npm config get prefix)/bin）已加入 - Windows：检查系统环境变量 PATH 是否包含 npm 全局路径（通常为
%AppData% pm），重启 Sublime 后生效 - 验证方式：在 Sublime 中按
Ctrl+Shift+P→ 输入Build With→ 选Exec，临时建个.sh或.bat构建文件，用echo $PATH（macOS/Linux）或echo %PATH%（Windows）看输出是否含tsc所在目录
创建自定义 TypeScript 构建系统（.sublime-build）
Sublime 的构建系统本质是 JSON 配置，核心是正确指定 cmd、selector 和工作目录。不要依赖插件自动创建，手动写更可控。
- 菜单栏 →
Tools→Build System→New Build System… - 替换全部内容为以下配置（适配常见项目结构）：
{
"cmd": ["tsc", "$file"],
"selector": "source.ts",
"working_dir": "${project_path:${folder}}",
"file_regex": "^(.*\.ts)\:(\d+)\,(\d+)\:\s+(.*)$",
"variants": [
{
"name": "Watch",
"cmd": ["tsc", "-w", "$file"]
}
]
}
说明："working_dir" 设为项目根目录，确保 tsc 能读到 tsconfig.json；"file_regex" 支持点击错误跳转到对应行；"variants" 提供 Ctrl+Shift+B 选 TypeScript – Watch 启动监听模式。
tsconfig.json 必须存在且位置合理
tsc 默认只在当前工作目录或逐级向上查找 tsconfig.json。如果构建时提示 error TS5058: The specified path does not exist 或编译结果不符合预期，八成是配置文件缺失或层级错位。
- 推荐放在项目根目录（即
working_dir所指位置），内容至少包含：
{
"compilerOptions": {
"target": "ES2020",
"module": "commonjs",
"outDir": "./dist",
"rootDir": "./src",
"strict": true,
"skipLibCheck": true
},
"include": ["src/**/*"]
}
注意："rootDir" 和 "outDir" 决定输入/输出路径映射；若未设 "rootDir"，tsc 会把 $file 的绝对路径当作源根，导致 outDir 下生成深层嵌套目录 —— 这是编译后文件乱套的最常见原因。
调试构建失败：从输出面板看真实错误
按 Ctrl+B 后如果没反应或一闪而过，别急着重配，先打开 Sublime 底部的 Build Results 面板（Ctrl+` 切换）。里面显示的是原始 shell 输出，比弹窗提示更准。
- 出现
error TS18003: No inputs were found→tsconfig.json不存在，或working_dir指向了错误目录 - 出现
error TS2688: Cannot find type definition file→ 缺少@types/node等类型包，需npm install --save-dev @types/node - 编译成功但无 JS 文件生成 → 检查
tsconfig.json中"noEmit"是否为true，或"outDir"路径不可写
真正卡住的地方往往不是 Sublime 配置语法，而是 TypeScript 自身的工程约束没满足——比如 tsconfig.json 里 "composite": true 但没配 "references"，这种错误只会出现在构建输出里，不会给任何友好提示。
