sublime text 本身不支持 typescript,所有功能均依赖本地 tsc 和 tsserver;需全局或项目级安装 typescript、正确配置 tsserver_path 路径、确保 tsconfig.json 存在且被识别,并通过 sublimetsc 插件桥接实现类型检查与智能提示。

Sublime Text 本身不支持 TypeScript,所有功能(补全、跳转、错误提示、编译)都依赖你本地安装的 tsc 和 tsserver;没装或路径不对,插件就只剩语法高亮。
确认 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;v14 已过时,v16 虽可用但部分插件兼容性差
- 全局安装:
npm install -g typescript;项目级安装(如用pnpm)则后续需显式指定路径
选对插件:只装 SublimeTSC,别碰 TSCompleteMe
TSCompleteMe 已多年未更新,不兼容 Sublime Text 4,大量 issue 报告“补全失效”“崩溃”;SublimeTSC 是当前唯一轻量、活跃维护、只专注桥接 tsserver 的方案。
完整的Galileo AI平台 TypeScript/JS SDK 参考,用于评估、观察和保护 GenAI 应用。适用于构建 Node.js 或 TypeScript 项目。
- Cmd+Shift+P(macOS)或 Ctrl+Shift+P(Win/Linux)→ 输入
Package Control: Install Package→ 搜索并安装SublimeTSC - 安装后打开任意
.ts文件,状态栏左下角应显示TS,右键菜单出现TypeScript子项 - 别装
TypeScript-Sublime-Plugin(ms-vscode 官方那个),它自带旧版内嵌tsserver,不读tsconfig.json,也不支持现代编译选项
手动配置 tsserver_path:解决“没提示”“无跳转”
默认尝试调用全局 tsserver,但如果你用了 nvm/fnm/volta、或项目是 pnpm/yarn 管理、或 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" - 如果项目没装 TypeScript,先运行
pnpm add -D typescript或yarn add -D typescript
配置构建系统:让 tsc 正确编译
Sublime 本身不编译 TS,必须靠构建系统调用 tsc 并设对 working_dir,否则会报 error TS5058: The specified path does not exist。
- 推荐用
npx tsc而非裸tsc:避免全局版本和项目依赖冲突 - 构建系统里必须指定
working_dir为项目根目录,否则tsc找不到tsconfig.json - 示例构建配置(保存为
TS.sublime-build):{ "cmd": ["npx", "tsc", "$file"], "working_dir": "${project_path:${folder}}", "selector": "source.ts", "shell": true } - 如果用了
paths或baseUrl,构建系统里加"args": ["--project", "."]强制从当前目录找配置
最常被忽略的是 tsserver_path 的路径是否真能执行,以及 tsconfig.json 是否在构建时被加载——这两点出错,编辑器里看着正常,实际类型检查和路径解析全失效。










