Sublime怎么配置TypeScript环境？Sublime安装TS插件详细步骤
先明确一个核心判断：tsserver 找不到、Ctrl+Click 跳转失效、错误提示不出现——这些问题十有八九，根源都不在插件本身。真正的问题往往是 tsserver 根本没连上，或者压根就没安装。
确认本地已安装 tsc 和 tsserver
这里有个关键认知：Sublime Text 的 TypeScript 智能功能，完全依赖于你系统里真实存在的 tsc 和 tsserver。插件只是个桥梁，它本身不提供这些工具。如果本地没有，那插件就只能提供基础的语法高亮，其他高级功能一概免谈。
- 第一步，打开终端，运行
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。v14 已经过时，v16 虽然还能用，但部分插件的兼容性可能会打折扣。
- 安装方式上，全局安装最省心：
npm install -g typescript。但如果你的项目用的是 pnpm 这类包管理器，TypeScript 是安装在项目本地的，那么后续就必须进行一项关键配置。
装对插件：只用 SublimeTSC，别碰 TSCompleteMe
插件选择上，有个常见的坑。很多教程会提到 TSCompleteMe，但这个插件已经多年没有更新，完全不兼容 Sublime Text 4，社区里充斥着“补全失效”、“编辑器崩溃”的反馈。目前来看，SublimeTSC 是唯一轻量、活跃维护、且只专注于桥接 tsserver 的可靠方案。
- 安装很简单：按下
Cmd+Shift+P（macOS）或Ctrl+Shift+P（Win/Linux），调出命令面板，输入Package Control: Install Package，然后搜索并安装SublimeTSC。 - 安装成功后，随便打开一个
.ts文件，注意观察状态栏左下角，应该会显示TS标识。同时，在文件上点击右键，菜单里应该会出现TypeScript的子项。 - 另外提一嘴，不要安装那个叫
TypeScript-Sublime-Plugin的插件（就是微软 vscode 官方那个）。它内部嵌了一个旧版本的tsserver，既不读取项目的tsconfig.json，也不支持现代的编译选项，用起来反而束手束脚。
手动配置 tsserver_path：最常被跳过的一步
这才是关键所在。默认情况下，SublimeTSC 会尝试调用全局的 tsserver。但现实情况往往更复杂：如果你用了 nvm、fnm 或 volta 这类 Node 版本管理器，或者项目是用 pnpm、yarn 管理的，TypeScript 只安装在项目本地，那么插件大概率会找不到路径——此时，就必须手动指定 tsserver_path。
- 打开菜单：
Preferences → Package Settings → SublimeTSC → Settings。 - 在右侧的用户设置（User Settings）中，添加如下配置（特别注意路径的写法）：
{
"tsserver_path": "./node_modules/.bin/tsserver",
"tsserver_options": ["--locale", "zh-CN"]
}
- macOS 和 Linux 用户用上面的写法即可；Windows 用户需要特别注意，路径要改为：
"./node_modules/.bin/tsserver.cmd"。 - 当然，前提是你的项目里已经安装了 TypeScript。如果还没装，先在项目根目录运行
pnpm add -D typescript或yarn add -D typescript。 - 至于
tsserver_node_path这个配置项，不填通常也没问题。但如果填了，就必须确保它指向一个真实可用的node可执行文件（可以用which node命令来查看路径）。
让 .ts 文件自动识别语法 + 设置构建系统
插件装好后，你可能会发现打开 .ts 文件，语法高亮还是“纯文本”（Plain Text）模式。这其实是正常现象，需要手动关联一下语法。
- 打开一个
.ts文件，看编辑器右下角，点击当前显示的语法名称（比如Plain Text），在弹出的列表中选择TypeScript。 - 如果想一劳永逸，可以点击菜单栏的
View → Syntax → Open all with current extension as… → TypeScript。这样以后所有.ts文件都会自动识别为 TypeScript 语法。 - 如果想在 Sublime 里直接编译 TypeScript 文件，还需要配置构建系统。这里推荐使用
npx tsc命令，它能避免全局 TypeScript 版本和项目本地版本的冲突。配置如下：
{
"cmd": ["npx", "tsc", "$file"],
"working_dir": "${project_path:${folder}}",
"selector": "source.ts",
"shell": true
}
- 将上述配置保存为
TS.sublime-build文件。之后，在打开.ts文件时，按下Ctrl+B（Win/Linux）或Cmd+B（macOS）就可以执行编译了。 - 这里有个细节需要注意：如果项目的
tsconfig.json不在当前目录，或者项目是 monorepo 结构，那么working_dir这个参数就必须设置正确。否则，tsc会找不到配置文件，并报出error TS5058这类错误。
话说回来，整个配置过程里，真正麻烦的从来不是点击安装插件，而是背后那一连串的路径和上下文匹配问题：Node 版本管理器（nvm/fnm）、包管理器（pnpm/yarn）、tsconfig.json 的位置、working_dir 是否指向了项目根目录——这些环节里任何一个出错，都可能导致 tsserver 静默失败，连个错误提示都不会给你。
