必须确保tsc和tsserver可在终端运行且版本一致,安装sublimetsc插件,手动配置tsserver_path指向本地tsserver.js,并将.ts文件语法绑定为typescript。

确认 tsc 和 tsserver 能在终端里跑起来
没这一步,后面全白搭。Sublime 的 TS 插件不自带编译器,它只是把请求转发给本地 tsc 和 tsserver,这两个命令必须能在终端直接执行,且版本一致。
- 运行
tsc --version,输出类似Version 5.4.5才算通过;没输出说明根本没装 TypeScript - 运行
tsserver --version,版本号必须和tsc完全一致;报command not found说明node_modules/.bin没进系统$PATH - Windows 用户查「系统环境变量」→「Path」,确认 Node.js 安装路径下的
node_modules\.bin已加入;macOS/Linux 运行echo $PATH看有没有该路径 - Node.js 推荐用 v18 或 v20;v16 偶尔出兼容问题,v14 已彻底过时
只装 SublimeTSC,别碰其他 TS 插件
装错插件是功能失效的第二常见原因。当前唯一轻量、活跃维护、专注桥接 tsserver 的插件只有 SublimeTSC。
完整的Galileo AI平台 TypeScript/JS SDK 参考,用于评估、观察和保护 GenAI 应用。适用于构建 Node.js 或 TypeScript 项目。
- 别装
TSCompleteMe:多年未更新,不兼容 Sublime Text 4,大量用户反馈补全失效、崩溃 - 别装
TypeScript-Sublime-Plugin(ms-vscode 官方老插件):自带旧版内嵌tsserver,完全不读项目里的tsconfig.json,也不支持paths、baseUrl等现代配置 - 安装方式:按
Ctrl+Shift+P(Win/Linux)或Cmd+Shift+P(macOS)→ 输入Package Control: Install Package→ 搜索并安装SublimeTSC - 装完打开任意
.ts文件,状态栏左下角应显示TS,右键菜单出现TypeScript子项
手动配 tsserver_path,否则补全/跳转全失效
SublimeTSC 默认尝试调用全局 tsserver,但绝大多数现代项目都用本地安装(pnpm add -D typescript 或 yarn add -D typescript),路径一错,语言服务就断联。
- 打开
Preferences → Package Settings → SublimeTSC → Settings - 在右侧用户设置中填入路径:
"tsserver_path": "./node_modules/typescript/lib/tsserver.js" - Windows 用户也用正斜杠,不要写成反斜杠;macOS/Linux 同样用这个路径写法
- 如果项目没装 TypeScript,先运行
pnpm add -D typescript或yarn add -D typescript - 路径必须指向
tsserver.js(不是tsserver可执行文件),这是SublimeTSC实际加载的语言服务入口
确保 .ts 文件语法绑定为 TypeScript
这是最常被忽略的第一步。装完插件 ≠ 自动识别 .ts 文件,Sublime 默认把它当 Plain Text 处理。
- 打开任意
.ts文件 → 点击右下角当前语法名(比如Plain Text)→ 选择TypeScript(注意不是JavaScript或TypeScriptReact) - 如果列表里没有
TypeScript,说明语法包没加载:用Ctrl+Shift+P→ 输入Package Control: Install Package→ 安装TypeScriptSyntax(轻量、更新勤) - 想永久生效:菜单 →
View → Syntax → Open all with current extension as…→ 再选TypeScript
tsserver_path 指向了可执行文件而非 tsserver.js,或者 .ts 文件根本没绑定正确语法——这两处一错,编辑器里就只剩高亮,其他全是静默失败。










