Sublime Text 的 TypeScript 插件需手动关联 .ts/.tsx 文件语法、配置 tsserver 路径、启用 JSX 支持，并确保 tsconfig.json 被正确加载，否则将导致无高亮、类型报错、跳转失败等问题。
Sublime Text 装完 TypeScript 插件却没语法高亮？
不是插件没装对，是 Sublime Text 默认不自动关联 .ts 文件类型。装完 TSComplete 或 TypeScript-Sublime-Plugin 后，得手动指定语法模式。
- 打开一个
.ts文件 → 点击右下角当前语法名称（比如 “Plain Text”）→ 选TypeScript - 想永久生效：菜单栏
View → Syntax → Open all with current extension as… → TypeScript - 如果列表里没有
TypeScript，说明插件没正确加载，检查Package Control → List Packages是否真有对应包名，再确认插件目录下存在typescript.sublime-syntax或Typescript.tmLanguage
tsconfig.json 配置写对了，但 Sublime 还是报“Cannot find name 'Promise'”？
Sublime 的 TypeScript 插件（如 TypeScript-Sublime-Plugin）默认用自带的旧版 tsserver，不读你项目里的 tsconfig.json，也不自动识别 lib 或 target 设置。
- 必须在插件配置里显式指定
tsserver路径：菜单Preferences → Package Settings → TypeScript → Settings，填入"tsserver_path": "./node_modules/typescript/lib/tsserver.js"（相对路径需以./开头） - 确保项目根目录有
node_modules/typescript，且版本 ≥ 4.0（老版本对 ES2015+ lib 支持弱） - 插件不会自动监听
tsconfig.json变更，改完配置要重启 Sublime 或执行TS: Restart Server命令（按Ctrl+Shift+P输入）
为什么 Ctrl+Click 跳转定义总失败？
跳转依赖 tsserver 的语义分析能力，而 Sublime 插件和 tsserver 之间通信容易卡在路径或上下文问题上。
- 跳转前先确认光标停在有效标识符上（不能在字符串、注释或空格里）
- 确保文件已保存——未保存的缓冲区内容不会被
tsserver索引 - 如果项目用了
paths别名，仅靠baseUrl不够，得在插件设置里加"tsserver_options": ["--project", "."]，强制走完整项目模式 - 遇到跳转到声明文件（
.d.ts）却显示空白？那是插件没加载对应库的类型定义，检查node_modules/@types/是否存在，或运行npm install --save-dev @types/node等对应包
Sublime + TypeScript 写 React 时 JSX 标签全标红？
不是语法错误，是插件没启用 JSX 支持，或者 tsconfig.json 里 jsx 选项没生效。
- 插件配置中必须开启 JSX：
"jsx": "preserve"或"react"（取决于你是否用 Babel 编译） - 确保
tsconfig.json在项目根目录，且插件设置里"tsserver_options"包含--project . - Sublime 默认不识别
.tsx后缀——打开.tsx文件后，右下角手动选TypeScriptReact语法（不是TypeScript） - 如果用了自定义 JSX 运行时（如
Preact），还需在tsconfig.json中配"jsxImportSource": "preact"，否则类型检查会漏报
最常被忽略的一点：Sublime 的 TypeScript 插件本质是轻量包装器，它不替代 tsc 或 tsserver 本身。所有类型检查、跳转、补全的可靠性，最终取决于你本地 node_modules/typescript 的版本、路径是否可访问、以及 tsconfig.json 是否被真实加载。别指望装个插件就万事大吉。
