根本原因是tsserver未连接或tsconfig.json未被正确加载;需确认tsserver_path配置正确、项目根目录存在tsconfig.json、右下角语法设为TypeScript,并通过控制台日志验证服务启动状态。

tsserver 没连上,所有高阶校对都静默失效
不是插件没装,而是 Sublime Text 根本没把 tsserver 启起来——它不报错、不弹窗,只让你以为“功能坏了”。真正起作用的不是插件 UI,是后台那个 tsserver 进程是否被正确加载、启动、并读到 tsconfig.json。
验证方式很简单:Ctrl+` 打开控制台,打开一个 .ts 文件,看有没有类似 Starting tsserver with: ... 的日志;如果没有,只有一行 Could not start server: Error: spawn tsserver ENOENT,说明路径填错了或 tsserver 根本不可执行。
- 必须在终端里先跑通:
tsc --version和tsserver --version输出一致,且非空 -
tsserver不在$PATH里?别指望 Sublime 自动继承你终端的环境变量,尤其用了nvm或volta的用户 - Windows 用户注意:
tsserver_path填"./node_modules/.bin/tsserver.cmd",不是.js文件 - 路径用相对路径(以
./开头),避免全局安装带来的版本错配问题
tsconfig.json 被忽略,strict / paths / jsx 全部不生效
tsserver 启动成功 ≠ 配置生效。它默认只从当前打开文件的路径向上查找 tsconfig.json,如果文件不是在项目根目录下打开的,哪怕配置写得再全,也只会用默认值降级运行。
常见表现:any 不标黄、import 报 Cannot find module、React.FC 提示类型错误、jsx 选项完全没反应。
- 确保
tsconfig.json在项目根目录(即包含package.json的那一层) - 打开 Sublime 时,用
File → Open Folder...直接打开该目录,而不是单个.ts文件 - 检查
tsconfig.json中的"compilerOptions": { "jsx": "react-jsx" }是否存在,且"lib"包含"ES2015"及以上 - 改完
tsconfig.json后,必须手动重启服务:按Ctrl+Shift+P→ 输入TS: Restart Server
语法没绑定,.ts 文件仍是 Plain Text
这是最常被跳过的一步:Sublime 默认不认识 .ts 后缀,装完插件也不会自动关联。你看到的是纯文本,连高亮都没有,更别说校对了。
完整的Galileo AI平台 TypeScript/JS SDK 参考,用于评估、观察和保护 GenAI 应用。适用于构建 Node.js 或 TypeScript 项目。
右下角显示 Plain Text 或 JavaScript?那根本没进 TypeScript 语法引擎,后续所有功能都会断链。
- 打开任意
.ts文件 → 点击右下角当前语法名 → 选择TypeScript(不是TypeScriptReact或Babel) - 若列表里没有
TypeScript,说明语法包没装对:用Ctrl+Shift+P→Package Control: Install Package→ 安装TypeScriptSyntax(注意大小写和空格) - 装完必须重启 Sublime Text 4,否则
.sublime-syntax不会加载 - 永久绑定:
View → Syntax → Open all with current extension as… → TypeScript
tsx 文件 JSX 支持失效,报错“JSX element type does not have any construct or call signatures”
.tsx 不是 .ts 加个 x 那么简单。它需要两层支持:语法高亮识别 JSX 结构 + tsserver 启用 JSX 编译模式。
只配了 jsx 但没装对语法包,或者只装语法包但没告诉 tsserver 启用 JSX,都会导致解析失败。
- 确认已安装
TypeScriptSyntax,并在Preferences → Settings – Syntax Specific中加:"extensions": ["ts", "tsx"] - 在插件配置(如
SublimeTSC的 Settings)中显式启用:"enable_tsx": true -
tsconfig.json中必须有:"compilerOptions": { "jsx": "react-jsx" }(TS 4.1+ 推荐) - 重启
tsserver:改完配置后必须执行TS: Restart Server,否则缓存不刷新
复杂点在于:语法绑定、tsserver 路径、tsconfig 位置、tsx 启用开关,这四者缺一不可。漏掉任何一个,高阶校对就退化成基础高亮。

















