ctrl+click跳转失效等问题90%源于tsserver未连上或未安装,需确认tsc/tsserver已全局或本地安装且版本一致,sublimetsc插件正确配置tsserver_path,并确保.ts文件语法识别与tsconfig.json上下文匹配。

tsserver 找不到,Ctrl+Click 跳转失效,错误提示不出现——这些问题 90% 都不是插件没装对,而是 tsserver 没连上,或者根本没装。
确认本地已安装 tsc 和 tsserver
Sublime 的 TypeScript 功能完全依赖你系统里真实存在的 tsc 和 tsserver,不是插件自带的。没装,就只剩语法高亮。
- 终端运行
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)则后续必须显式指定tsserver_path
装对插件:只用 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:最常被跳过的一步
默认情况下 SublimeTSC 尝试调用全局 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 -
tsserver_node_path不填也行,但若填了,必须指向真实可用的node可执行文件(用which node查)
让 .ts 文件自动识别语法 + 设置构建系统
刚装完插件,打开 .ts 文件可能还是 Plain Text ——这是默认行为,需手动关联。
- 打开一个
.ts文件 → 点击右下角当前语法名(如Plain Text)→ 选择TypeScript - 想永久生效:菜单栏
View → Syntax → Open all with current extension as… → TypeScript - 要编译 TS,得配构建系统。推荐用
npx tsc避免全局/项目版本冲突:
{
"cmd": ["npx", "tsc", "$file"],
"working_dir": "${project_path:${folder}}",
"selector": "source.ts",
"shell": true
}
- 保存为
TS.sublime-build,之后按Ctrl+B(Win/Linux)或Cmd+B(macOS)即可编译 - 如果
tsconfig.json在子目录,或项目是 monorepo,working_dir必须设对,否则tsc找不到配置,报error TS5058
tsconfig.json 位置、working_dir 是否匹配项目根目录——这些地方错一个,tsserver 就静默失败,没有任何报错提示。










