优先安装 Microsoft 官方 TypeScript 插件,通过 Package Control:Ctrl+Shift+P → “Package Control: Install Package” → 输入“TypeScript”并回车;需全局安装 TypeScript(npm install -g typescript)并配置 tsserver_path 路径,否则仅支持语法高亮。

怎么用 Package Control 安装 TypeScript 插件
Sublime Text 本身不内置 TypeScript 支持,必须通过插件补全语法高亮、错误提示和基础补全。最稳定、维护活跃的是 TSComplete 和官方推荐的 TypeScript(由 Microsoft 维护)。优先选后者,它基于 tsserver,支持跳转、重命名、重构等核心功能。
安装步骤很直接:
- 确保已安装
Package Control(没装就先按Ctrl+Shift+P→ 输入Install Package Control回车) - 再按
Ctrl+Shift+P→ 输入Package Control: Install Package→ 等加载完成 - 输入
TypeScript,选中并回车(注意不是Typescript或tscomplete,大小写和拼写要准)
装完后重启 Sublime,打开一个 .ts 文件,状态栏右下角应显示 TypeScript,说明激活成功。
为什么装了插件却没补全、没报错
常见原因是插件没连上本地 tsserver——它不是纯前端插件,依赖 Node.js 环境里的 TypeScript 包。插件默认会尝试调用全局安装的 tsserver,但多数人没装或路径不对。
解决方法:
- 在终端运行
npm install -g typescript(确保 Node.js 已安装) - 检查
tsserver是否可用:which tsserver(macOS/Linux)或where tsserver(Windows) - 如果路径是
/usr/local/bin/tsserver这类,需在 Sublime 的插件设置里显式指定:Preferences → Package Settings → TypeScript → Settings,填入:"tsserver_path": "/usr/local/bin/tsserver"
- Windows 用户若用 npm 全局安装,路径通常是
%APPDATA%\npm\tsserver.cmd,需写成正斜杠或双反斜杠
不配 tsserver_path,插件只会做基础语法高亮,不会有类型检查或智能补全。
如何让 TS 插件识别 node_modules 和 @types
插件默认只读当前文件所在目录下的 tsconfig.json。如果你项目结构是多层嵌套(比如 src/ 下写代码,tsconfig.json 在根目录),Sublime 可能找不到配置,导致 import 补全失败、@types 不生效。
关键动作是确认 tsconfig.json 位置,并让插件“看到”它:
- 把
tsconfig.json放在项目根目录(即你用File → Open Folder打开的那个文件夹) - 检查
tsconfig.json中是否启用了"typeRoots"或"types"字段,例如:"typeRoots": ["./node_modules/@types"]
- 如果用 Yarn PnP 或 pnpm,
@types可能不在node_modules下,插件目前不原生支持,得改用typescript-tslint-plugin配合自定义路径,但复杂度陡增——建议开发时还是用常规node_modules
补全卡顿、CPU 占用高怎么办
TypeScript 插件启动后会常驻一个 tsserver 进程,对大型项目(尤其含大量 node_modules 或复杂类型推导)容易响应慢。这不是插件 bug,而是 tsserver 自身行为。
可调优的点:
- 在
tsconfig.json中加"exclude": ["node_modules", "dist"],避免扫描无关目录 - 关闭 Sublime 的自动构建:去掉
Preferences → Settings里的"build_on_save",否则每次保存都触发完整类型检查 - 插件设置里关掉实时诊断:
"diagnostics_delay": 0
改成"diagnostics_delay": 1000
(延迟 1 秒再检查) - 不用时手动停掉服务:命令面板输
TypeScript: Stop Server,需要时再Start Server
真正难搞的是单文件无 tsconfig.json 场景——插件会 fallback 到默认配置,类型推导能力大幅缩水,这时候补全基本靠猜,别太依赖。










