在 Sublime Text 里配置 TypeScript 时，最常见的问题是：插件装上了，但代码补全没有提示，跳转也失效。

Sublime Text 本身并不原生支持 TypeScript。装完插件没反应，90% 的情况是配置没跟上——要么没配 tsserver_path，要么连 tsc 都没装到位。这不是插件不行，而是路径和依赖没对齐。

先明确核心原因

所有功能都依赖本地的 tsserver 来提供语义分析。Sublime 插件本质上只是一个“转发器”。

它不会帮你安装 Node.js，也不会自动去项目里找 node_modules。因此，必须手动把依赖和路径锚定好。

确认 tsc 和 tsserver 真的可用

任何功能生效的前提，是终端能顺利调用 tsserver。先确认下面几点：

• 终端执行 tsc --version，必须有输出（比如 Version 5.4.5）
• 再执行 tsserver --version，版本号要和 tsc 一致；如果报 command not found，说明 node_modules/.bin 没进入系统 PATH
• macOS/Linux 检查 echo $PATH，确认包含 ~/.npm-global/bin 或 /usr/local/bin；Windows 的话，检查系统环境变量中 Node.js 安装路径下的 node_modules.bin
• Node.js 推荐 v18 或 v20；v14 已过时，v16 在部分插件里会出兼容问题

插件选择很关键

只用 SublimeTSC，别碰过时方案

真正还能稳定用到今天的，只有 SublimeTSC。

市场上类似名字的插件不少，但很多已经过时。像 TSCompleteMe 多年未更新，根本不兼容 Sublime Text 4，大量用户反馈补全失效甚至崩溃。

TypeScript-Sublime-Plugin 自带旧版内嵌 tsserver，既不读 tsconfig.json，也不支持像 moduleResolution: bundler 这类现代编译选项。

• 直接用 Package Control 安装 SublimeTSC（注意名称没有空格，不是 Sublime Text TypeScript）
• 安装后打开一个 .ts 文件，状态栏左下角应该能看到 TS 标识，右键菜单里会出现 TypeScript 子项
• 别装 TSFormatter 或 SublimeLinter-tslint，它们已经废弃，不支持 TS 4.0+ 和 ST4

重点配置：手动填 tsserver_path

这是“没提示”“跳转失败”的最大原因

SublimeTSC 默认会尝试调用全局的 tsserver。但如果你用了 nvm/volta，或者项目是用 pnpm 管理的，又或者 TypeScript 是本地安装的，它大概率找不到。

这种情况下，必须手动硬编码路径。

• 打开 Preferences → Package Settings → SublimeTSC → Settings
• 在右侧用户设置中添加：

  {  "tsserver_path": "./node_modules/.bin/tsserver",  "tsserver_options": ["--locale", "zh-CN"]}

• macOS/Linux 用上面写法；Windows 用户改成 "./node_modules/.bin/tsserver.cmd"
• 注意路径是相对于你当前打开的文件夹（即项目根目录），不是 Sublime 的安装目录。如果项目没装 TypeScript，先运行 pnpm add -D typescript 或 yarn add -D typescript
• 如果要用全局安装，路径类似 /usr/local/lib/node_modules/typescript/lib/tsserver.js（macOS/Linux）或 C:UsersxxxAppDataRoamingnpmnode_modulestypescriptlibtsserver.js（Windows）

让 .ts 和 .tsx 正常识别

装了插件，并不代表 .ts 文件会自动高亮。Sublime 默认不关联扩展名，需要手动指定。

• 打开一个 .ts 文件 → 点击右下角当前语法名（比如 Plain Text）→ 选择 TypeScript
• 要永久生效：菜单 View → Syntax → Open all with current extension as… → TypeScript
• 为支持 .tsx，在 Preferences → Settings – Syntax Specific 中加上：

  "extensions": ["ts", "tsx"]

• 如果列表里没有 TypeScript，说明插件没加载成功，检查 Package Control → List Packages 是否有 SublimeTSC，再确认插件目录下是否存在 typescript.sublime-syntax

最后几个容易忽略的细节

改完 tsserver_path 后，必须重启 Sublime，或者至少重开 .ts 文件。

tsconfig.json 必须放在项目根目录，不能用软链接或多根工作区。否则插件找不到配置。

这些条件没对齐时，类型检查就会降级成“无配置模式”。strict、paths、jsx 全部失效。

把上面几步走完，Sublime Text 里的 TypeScript 体验才算真正上线。