Ctrl+Click无法跳转、悬停无类型提示、any不标黄，根本原因是tsserver未正确启动或未加载tsconfig.json；Sublime Text所有语言功能均依赖tsserver进程，而它默认不自动启动、也不自动查找配置。

为什么 Ctrl+Click 跳不到定义、悬停没类型、any 不标黄

根本不是插件没装，是 tsserver 没真正跑起来，或者它压根没读到你的 tsconfig.json。Sublime Text 本身不提供任何语言功能，所有提示、跳转、类型检查都靠 tsserver 进程支撑——而这个进程默认不会自动启动，也不会自动找配置。

• 打开 .ts 文件后按 Ctrl+` 看控制台：如果完全没出现 Starting tsserver with: 日志，说明插件根本没触发（常见于右下角显示的是 Plain Text 或 JavaScript）
• 看到 Could not start server: Error: spawn tsserver ENOENT → tsserver_path 填错了，或系统 PATH 里找不到 tsserver
• 看到 Starting tsserver with: [] 但后续无报错、无跳转 → 检查当前文件是否在项目根目录下打开（tsserver 默认只从当前视图路径向上查找 tsconfig.json）
• tsconfig.json 存在但被忽略？常见原因：baseUrl 写成绝对路径、paths 别名没配 baseUrl、或 moduleResolution 设为 node16 却混用 require()

如何让 .ts 文件一打开就有语法高亮和补全

Sublime Text 4 不会根据扩展名自动识别 .ts，必须手动绑定语法，且语法包必须兼容 ST4。装了插件 ≠ 有高亮，重启编辑器 ≠ 自动生效。

Add Typescript Best Practices

在 CLAUDE.md 中配置 TypeScript 最佳实践和代码风格规则

下载

• 临时：打开任意 .ts 文件 → 点右下角当前语法名（如 Plain Text）→ 选 TypeScript（注意不是 TypeScriptReact 或 JavaScript）
• 永久：选好后，菜单 View → Syntax → Open all with current extension as… → TypeScript
• 如果菜单里没有 TypeScript 选项 → 必须安装 TypeScriptSyntax（作者 sublimelsp），别装已废弃的 Typescript Syntax 或 TypeScript-Sublime-Plugin
• 装完必须重启 Sublime Text 4；若仍无效，检查 Packages/User/ 下是否有空的 TypeScript.sublime-syntax，有就删掉（ST4 会优先加载 User 目录同名文件）
• 确认用户设置中启用了 "auto_complete": true，否则 Ctrl+Space 永远不弹窗

tsserver_path 怎么填才不踩坑

tsserver_path 是最常填错的配置项。它不是“随便找个能运行的路径”，而是决定 tsserver 是否能读取项目级 tsconfig.json、是否与 tsc 版本一致的关键。

• 推荐填相对路径："./node_modules/.bin/tsserver"（macOS/Linux）或 "./node_modules/.bin/tsserver.cmd"（Windows）——这样它一定用项目里装的 TypeScript 版本
• 绝对路径如 /usr/lib/node_modules/typescript/lib/tsserver.js 极易版本错配，且无法读取项目 tsconfig.json 中的 paths、baseUrl 等配置
• tsserver_node_path 必须指向真实可用的 node 可执行文件（用 which node 查），留空或填错会导致整个服务静默失败
• 终端运行 tsc --version 和 tsserver --version 输出必须一致；若后者报 command not found，说明 node_modules/.bin 没进 shell 的 $PATH

TSX 文件里 JSX 语法报错或不识别

.tsx 不是 .ts 加个 X 就行，它需要显式启用 JSX 支持，否则 tsserver 会当普通 TS 解析，直接报 JSX element type does not have any construct or call signatures 类错误。

• 确保语法包支持：安装 TypeScriptSyntax 后，在 Preferences → Settings – Syntax Specific 里加一行："extensions": ["ts", "tsx"]
• 如果是用 SublimeText-Typescript 插件，在其设置里加："enable_tsx": true
• 如果用 LSP-typescript，不用手动开 enable_tsx，但必须确认 tsconfig.json 里 "jsx" 字段设对了（比如 "preserve" 或 "react"）
• 改完配置后，必须手动触发 Ctrl+Shift+P → TypeScript: Restart Server（LSP 用户则用 LSP: Restart Servers），否则新配置不加载

关键点在于：所有功能都依赖三个东西同时就位——文件被正确识别为 TypeScript 语法、tsserver 进程用项目级路径启动、tsconfig.json 在项目根目录且字段有效。缺一不可，且任一环节出错都表现为“没反应”，而不是报错。