Sublime怎么配置TypeScript_Sublime TS开发教程【现代】

sublime text 需安装 typescript-sublime-plugin 插件并手动关联 .ts 文件语法，配置 tsc 构建系统实现编译检查和错误跳转，且须确保 tsconfig.json 正确、tsserver 路径准确、多根项目单独配置。

TypeScript 在 sublime text 里没法原生跑，必须装插件 + 配置构建系统或语言服务器，否则连基础语法高亮和错误提示都没有。

怎么让 Sublime 正确识别 .ts 文件并高亮？

Sublime 默认不认 .ts 后缀，打开就是纯文本。得手动关联语法定义：

• 右下角点击当前文件的语法类型（比如 “Plain Text”），选 TypeScript；如果没这个选项，说明没装插件
• 推荐装 Package Control 后安装 Typescript-sublime-plugin（注意不是 SublimeTslint，那个已废弃）
• 装完后重启 Sublime，.ts 文件会自动用 TypeScript 语法高亮，Interface、type、泛型尖括号都会着色
• 别用 JavaScript (Babel) 语法强行打开 .ts 文件——类型注解会被标红，as const、?? 等新语法也不识别

为什么写完代码没报错，但实际编译失败？

Sublime 自身不运行 TypeScript 编译器（tsc），插件默认只做轻量语法检查，不校验类型兼容性或模块解析。

• Typescript-sublime-plugin 默认调用的是本地全局 tsserver（TypeScript 语言服务），但只在保存时触发一次检查，且不读取 tsconfig.json 的 compilerOptions 以外的部分
• 常见漏掉的点：baseUrl + paths 别名不生效、moduleResolution 设为 node16 时路径解析异常、skipLibCheck: true 不影响插件提示
• 想看到完整编译错误，得配构建系统：新建 Tools → Build System → New Build System，填入 tsc 命令，否则你写的 const x: number = "hello" 可能完全没提示

怎么配一个可用的 tsc 构建系统？

目标是保存后按 Ctrl+B（Win/linux）或 Cmd+B（macos）直接看到编译结果，而不是切终端。

• 确保本机已安装 TypeScript：npm install -g typescript 或项目内装 typescript 并设 PATH 指向 node_modules/.bin/tsc
• 构建系统内容示例（保存为 Typescript.sublime-build）：

{   "cmd": ["tsc", "--noEmit", "--skipLibCheck"],   "file_regex": "^(.*.ts?)((d+),(d+)):s+(error|warning) TSd+: (.*)$",   "selector": "source.ts, source.tsx",   "shell": true }

• --noEmit 很关键：只检查不生成 JS，避免污染源目录；去掉它就真编译了
• file_regex 必须严格匹配 tsc 错误格式，否则双击错误跳不到对应行
• windows 用户若提示 'tsc' is not recognized，把 "cmd" 改成 ["cmd", "/c", "tsc", "..."]，或用绝对路径

为什么用了 tsserver 还是跳转不到定义？

跳转失效通常不是插件问题，而是项目结构或配置没对齐。

• tsserver 需要找到项目的 tsconfig.json 根目录；如果文件在子文件夹打开，而 tsconfig.json 在上两级，就得手动告诉插件：Preferences → Package Settings → TypeScript → Settings，加 "typescript_tsdk": "./node_modules/typescript/lib" 和 "auto_complete": true
• 符号跳转依赖 outDir 和 rootDir 设置是否合理；如果 outDir 是 dist 但没启用 declaration: true，.d.ts 文件不存在，跳转就会断
• 别指望 import 路径别名（@/utils）自动解析——插件不会读 webpack.config.js 或 vite.config.ts，只能靠 tsconfig.json 的 baseUrl/paths，且必须重启 tsserver（插件里有命令）

真正麻烦的是多根工作区或 monorepo 场景：Sublime 不支持 VS Code 那种 tsconfig.json 继承链，每个文件夹得单独配好配置，否则类型推导和跳转会错乱。