先安装package control,再通过它安装microsoft官方typescript插件;接着配置本地tsserver路径并关联.ts文件语法,最后确保tsconfig.json位置正确且项目已重载。

怎么用 Package Control 安装 TypeScript 插件
Sublime Text 本身不内置 TypeScript 支持,得靠插件补上语法高亮、自动补全和错误提示。最稳的方式是通过 Package Control 装官方维护的 TypeScript 插件(由 Microsoft 官方团队维护,不是第三方山寨版)。
- 确保已安装
Package Control:没装的话,去官网复制那段 Python 安装脚本,粘贴进 Sublime 的Ctrl+`控制台执行 - 按
Ctrl+Shift+P(Win/Linux)或Cmd+Shift+P(macOS),输入Package Control: Install Package回车 - 等列表加载完,搜
TypeScript,点它——注意看作者是不是microsoft,别选错成TSFormatter或sublime-typescript(老版本已弃用) - 装完不用重启,但得手动把
.ts文件关联到 TypeScript 语法:右下角点击当前语法名(比如 “Plain Text”),选TypeScript
为什么打开 .ts 文件还是没语法高亮或报错
装了插件 ≠ 自动生效。TypeScript 插件依赖本地 tsserver(TypeScript 语言服务),它不会随插件一起装,得自己配好 Node.js 环境和全局 typescript 包。
- 终端运行
tsc --version,必须有输出(如5.3.3)。没有?先装 Node.js,再执行npm install -g typescript - Sublime 启动时会尝试找
tsserver,路径不对就静默失败。Windows 用户常卡在这儿:如果用 nvm 或不同 Node 版本管理器,tsserver可能不在默认 PATH 里 - 可以手动指定路径:菜单
Preferences → Package Settings → TypeScript → Settings,在右边加一行:"tsserver_path": "/path/to/node_modules/typescript/lib/tsserver.js"(Linux/macOS)或"tsserver_path": "C:\Users\xxx\AppData\Roaming\npm\node_modules\typescript\lib\tsserver.js"(Windows) - 改完设置保存,再关掉所有 .ts 文件,重新打开一个试试
tsconfig.json 不生效?检查插件是否读到了项目配置
TypeScript 插件会向上查找最近的 tsconfig.json 来决定编译选项、路径别名、JSX 模式等。但它只认标准结构,对软链接、多根工作区或自定义配置路径不敏感。
- 确认
tsconfig.json在当前文件所在目录或其任意父级目录下,且文件名全小写、无空格、无 BOM - 如果用了
"baseUrl"+"paths"别名,Sublime 插件支持,但要求"baseUrl"是相对tsconfig.json的路径(不能是绝对路径) - 插件不会监听
tsconfig.json变更,改完配置要手动重载:右键编辑器 →TypeScript: Reload Project - 某些严格校验项(如
"noImplicitAny")只影响 tsserver 报错,不影响 Sublime 界面显示;真要看效果,得写一行带隐式 any 的代码,等几秒看有没有波浪线
性能卡顿或 CPU 占用高怎么办
tsserver 是个常驻进程,Sublime 插件会为每个打开的 TS 项目启动一个实例。大项目、符号太多、或者插件反复重启时容易拖慢编辑器。
- 关掉不用的文件夹:Sublime 的
Project → Close Project比单纯关标签页更彻底,能释放对应tsserver进程 - 避免同时打开多个大型 TS 项目——插件没做跨项目共享
tsserver的优化 - 如果只是看代码不写,可在设置里加
"disable_diagnostics": true关掉实时检查,省资源 - Mac 上偶尔出现
tsserver残留进程,活动监视器里搜tsserver手动杀掉,再重启 Sublime
tsserver 是松耦合关系,出问题大概率卡在环境链路某一处:PATH、权限、路径大小写、配置位置。调试时优先确认 tsc --version 和 tsserver 是否可执行,比瞎试配置有效得多。











