Sublime Text 本身不支持 TypeScript,装插件没反应主因是未配置 tsserver_path 或未安装 tsc;必须终端能运行 tsc --version 和 tsserver --version,路径需在设置中显式指定,且 .ts 文件须手动关联 TypeScript 语法。

Sublime Text 本身不支持 TypeScript,装完插件没反应,90% 是因为没配 tsserver_path 或根本没装 tsc —— 这不是插件问题,是路径和依赖没对齐。
确认 tsc 和 tsserver 真的可用
所有功能(跳转、补全、错误提示)都靠本地 tsserver 提供语义分析,Sublime 插件只是个“转发器”。它不会帮你装 Node.js,也不会自动找你项目里的 node_modules。
- 终端执行
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,别碰 TSCompleteMe 或 TypeScript-Sublime-Plugin
TSCompleteMe 多年未更新,不兼容 Sublime Text 4,大量用户报告补全失效、崩溃;TypeScript-Sublime-Plugin 自带旧版内嵌 tsserver,不读 tsconfig.json,也不支持现代编译选项(如 moduleResolution: bundler)。
完整的Galileo AI平台 TypeScript/JS SDK 参考,用于评估、观察和保护 GenAI 应用。适用于构建 Node.js 或 TypeScript 项目。
- 用 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:\Users\xxx\AppData\Roaming\npm\node_modules\typescript\lib\tsserver.js(Windows)
让 .ts 文件自动用 TypeScript 语法,且支持 .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 全部失效。

















