必须验证tsserver进程是否启动：执行typescript: show server log，日志需含starting tsserver；tsserver --version须终端可运行，否则需修复path；项目级ts需手动设tsserver_path为./node_modules/.bin/tsserver（win加.cmd）；sublime环境变量独立，macos应将npm bin加入~/.zprofile，windows需确认%appdata% pm在系统path中；构建系统须配准working_dir和file_regex才支持错误跳转。

Sublime 本身不支持 TypeScript，装了插件 ≠ 能用。核心卡点永远是 tsserver 没跑起来，或者构建系统找不到 tsc —— 这两点没调通，语法高亮都可能不稳，更别说类型检查和编译。

怎么确认 tsserver 真正在工作

插件静默失败是常态，不能只看右下角显示 “TypeScript”。必须验证语言服务进程是否真正启动：

• 按 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（macOS），输入 TypeScript: Show Server Log 回车；日志里得有 Starting tsserver 和后续初始化信息，空白或报 Cannot find module 'typescript' 就说明路径错了
• tsserver --version 必须在终端里能执行成功；如果报 command not found，说明 npm 全局 bin 路径没进系统 PATH（macOS/Linux 查 $(npm config get prefix)/bin，Windows 查 %AppData% pm）
• 插件默认只认全局 tsserver，但项目用了 yarn 或 pnpm 装局部 typescript？那就得手动指定路径："tsserver_path": "./node_modules/.bin/tsserver"（macOS/Linux）或 "tsserver_path": "./node_modules/.bin/tsserver.cmd"（Windows）

为什么 Build System 总是报 'tsc' is not recognized

GUI 应用（如 Sublime）的环境变量和终端不共享，尤其 macOS/Linux 下 Shell 配置（~/.zshrc）对 Sublime 无效。这不是插件问题，是系统 PATH 加载机制差异：

Galileo TypeScript sdk

完整的Galileo AI平台 TypeScript/JS SDK 参考，用于评估、观察和保护 GenAI 应用。适用于构建 Node.js 或 TypeScript 项目。

下载

• 别依赖终端能运行就以为 Sublime 也能——在 Sublime 里按 Ctrl+Shift+P → 输入 Build With → 新建一个临时 .sh 构建，用 echo $PATH 看它实际读到的路径
• macOS 用户最稳妥的解法：把 export PATH="$(npm config get prefix)/bin:$PATH" 加进 ~/.zprofile（而非 ~/.zshrc），然后重启 Sublime
• Windows 用户直接检查系统环境变量里的 %AppData% pm 是否在 PATH 中，改完必须重启 Sublime 才生效

自定义 TypeScript.sublime-build 的关键字段

构建系统不是贴个 JSON 就完事，working_dir 和 file_regex 错一个，tsconfig.json 就白配，错误也不跳转：

• "working_dir": "${project_path:${folder}}" —— 强制以项目根目录为工作路径，确保 tsc 能正确加载 tsconfig.json；用 $file_path 容易导致配置文件找不到
• "file_regex": "^(.*\.ts):(\d+),(\d+):\s+(.*)$" —— 必须严格匹配 tsc 默认错误格式（注意转义点号和逗号），否则点击错误不会跳转到对应行
• "variants" 里加 "Watch" 很实用，但命令要用 ["tsc", "-w", "$file"]，不是 --watch（旧版写法已失效）；监听模式下需手动按 Ctrl+Break 停止

tsconfig.json 生效但插件不认 compilerOptions

这是最容易误解的一点：TypeScript 插件的实时提示（波浪线、跳转、补全）和 tsc 编译走的是两套逻辑。插件用轻量版 tsserver，只响应基础类型推导和模块解析，几乎不读 compilerOptions.strict、jsx、lib 等字段：

• 想让 noImplicitAny 报错？只能靠 Ctrl+B 触发构建，看控制台输出
• 插件会读 include/exclude 和 baseUrl+paths（但 baseUrl 必须是相对路径），其他字段基本忽略
• 如果你发现改了 tsconfig.json 后插件行为没变，别折腾设置，先 Ctrl+Shift+P → TypeScript: Reload Project 手动重载一次

真正麻烦的从来不是“怎么装”，而是 PATH、路径层级、插件与 CLI 工具的能力边界这三者之间的错位。每一步都得验证输出，而不是看界面有没有变。