Sublime如何配置TypeScript环境_Sublime安装TS高亮补全插件

Sublime Text 本身不支持 TypeScript，所有功能依赖本地 tsserver；必须安装 TypeScript、配置正确 tsserver_path 指向 tsserver.js，并将 .ts 文件语法设为 TypeScript，否则仅剩语法高亮。

说实话，很多人以为装上 Sublime 的 TypeScript 插件就万事大吉了，结果发现代码补全、跳转定义、类型检查统统没反应——这不奇怪。Sublime Text 骨子里并不自带 TypeScript 支持，所有“智能”功能都依赖你本地装的那个 tsserver，而且它还必须能被 Sublime 正确叫醒。路径对不上？那对不起，你只能看到一个带高亮的文本编辑器，跟记事本差别不大。

先确认 tsc 和 tsserver 能不能用

这是 90% 配置翻车的根源。Sublime 的 TS 插件本质上只是个“传话人”，真正干活的始终是你系统里的 TypeScript 工具链。

• 终端跑一下 tsc --version，应该输出类似 Version 5.4.5 这样的信息。
• 再跑 tsserver --version，版本号必须和 tsc 一致。如果报 command not found，说明 node_modules/.bin 没加到 $PATH（macOS/Linux 查 echo $PATH，Windows 看系统环境变量里 Node.js 安装路径下的 node_modules/.bin）。
• Node.js 建议用 v18 或 v20；v16 虽然也能用，但部分插件兼容性不太好；v14 已经过时，别用了。
• 安装 TypeScript：全局装就用 npm install -g typescript；如果是项目级安装（比如用了 pnpm），后面需要手动指定路径。

选对插件：只装 SublimeTSC，别碰另外两个坑

TSCompleteMe 久不更新，跟 Sublime Text 4 八字不合，GitHub issue 里全是“补全无效”和“崩溃”的哭诉；TypeScript-Sublime-Plugin 自带一个老掉牙的内嵌 tsserver，既不读 tsconfig.json，也不支持任何现代编译选项——装了等于白装。

• 按 Cmd+Shift+P（macOS）或 Ctrl+Shift+P（Win/Linux）→ 输入 Package Control: Install Package → 搜索并安装 SublimeTSC。
• 装完后随便打开一个 .ts 文件，看状态栏左下角是否显示 TS，右键菜单里有没有 TypeScript 子项——有，就对了。
• 记住：别碰那个 TypeScript-Sublime-Plugin（就是微软官方出的老插件），它已经跟不上时代了。

手动配置 tsserver_path：这一步漏了，补全/跳转/错误提示全都会失效

SublimeTSC 默认会去全局路径找 tsserver，但如果你用了 nvm、fnm、volta 这类版本管理工具，或者项目是用 pnpm/yarn 管理的，或者 TypeScript 是本地安装的——它大概率找不到。这时候必须硬编码路径。

• 打开 Sublime → Preferences → Package Settings → SublimeTSC → Settings。
• 在右侧用户设置里添加如下内容：

  {
    "tsserver_path": "/usr/local/lib/node_modules/typescript/lib/tsserver.js"
  }

• tsserver_path 必须指向 tsserver.js（注意：是 tsserver.js，不是那个可执行文件 tsserver）。具体位置取决于安装方式：
  • 全局 npm：执行 npm list -g typescript 找到路径，再拼上 lib/tsserver.js。
  • 项目本地：用 npm bin 或 npx which tsserver 定位到 node_modules/.bin/tsserver，然后换成对应的 lib/tsserver.js。
  • Windows 用户注意：路径里的反斜杠要改成正斜杠 /，例如 C:/Users/xxx/AppData/Roaming/npm/node_modules/typescript/lib/tsserver.js。

确保 .ts 文件被识别为 TypeScript 语法

装了插件并不等于 Sublime 会自动把 .ts 当成 TypeScript 来处理——它默认可能还在用纯文本或 Ja vaScript 语法高亮，那自然什么智能提示都出不来。

• 打开任意 .ts 文件 → 点击右下角当前语法名称（比如 “Plain Text”）→ 选 TypeScript（注意不是 Ja vaScript 也不是 TypeScriptReact）。
• 想要永久生效：菜单 View → Syntax → Open all with current extension as… → TypeScript。
• 再确认一下插件是否已启用：运行 Package Control: List Packages，检查列表里有没有 SublimeTSC。

最后，也是最容易踩的坑：Sublime 不会读取你 shell 里的 PATH，也不会自动顺着 node_modules/.bin 去找 tsserver。所以 tsserver_path 填错、填成了可执行文件而不是 tsserver.js、或者路径里混用了反斜杠——都会导致静默失败。表面上看起来一切正常，但类型检查、代码跳转全都没有，这才是最让人头疼的。