vs code 的 typescript 类型检查依赖 tsconfig.json 存在且配置正确，而非插件；需置于工作区根目录，配合 "typescript.tsdk" 指定本地版本、重启 ts server、合理设置 include/exclude、baseurl/paths、strict 等关键选项。

VS Code 本身不依赖“TypeScript 插件”来提供核心类型检查——它内置了 TypeScript 语言服务，真正起作用的是 tsconfig.json 是否存在、是否配置正确，以及 VS Code 是否加载了项目本地的 TypeScript 版本。

tsconfig.json 缺失或位置不对，VS Code 就只做语法高亮

没有 tsconfig.json，VS Code 不会启动项目级类型检查，所有 import 跳转失效、类型提示消失、any 泛滥都源于此。不是插件没装，是编辑器根本不知道该按什么规则解析 .ts 文件。

• 必须放在工作区根目录（不是子文件夹），多根工作区每个文件夹都要有自己的 tsconfig.json
• 新建项目别手写空文件，用 npx tsc --init 生成基础配置，哪怕先只保留 {} 也能让 VS Code 启动 TS 服务
• 如果项目用了 pnpm 或 bun，node_modules/typescript 路径可能异常，此时可在 .vscode/settings.json 中显式指定："typescript.tsdk": "./node_modules/typescript/lib"

TS Server 没加载对版本，VS Code 和 tsc 行为就对不上

VS Code 右下角显示的 TypeScript 版本号，决定了它用哪套规则做类型提示。若显示 “Bundled” 或 “v5.0.4 (Global)”，而你本地 package.json 里装的是 typescript@5.4.5，那类型检查结果必然不一致——常见表现是 VS Code 不报错，但 npx tsc 一堆错误。

Galileo TypeScript sdk

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

下载

• 按 Ctrl+Shift+P → 输入 TypeScript: Select TypeScript Version → 选 Use Workspace Version
• 每次改完 tsconfig.json，必须手动执行 TypeScript: Restart TS server，否则新配置不生效
• 如果频繁崩溃或跳转失败，优先删掉 node_modules 重装，再确认 typescript 和 @types/node 版本兼容

关键 compilerOptions 字段漏配，路径别名和 JSON 导入就直接挂掉

baseUrl 和 paths 不配，@/utils 这类别名在 VS Code 里 Ctrl+Click 会跳到 node_modules 里或报“无法找到模块”；不设 resolveJsonModule，读 import data from './config.json' 就红标。

• "baseUrl": "./" + "paths": { "@/*": ["src/*"] }：key 和 value 都必须带 /*，且 baseUrl 是相对于 tsconfig.json 的路径
• "strict": true 必须开，否则 noImplicitAny、strictNullChecks 等默认关闭，类型提示形同虚设
• "resolveJsonModule": true 和 "esModuleInterop": true 建议常开，尤其用现代构建工具时
• "skipLibCheck": false：设为 true 会跳过 node_modules 类型检查，第三方库补全和跳转会变弱

include/exclude 写错或没覆盖文件，类型检查就“看不见”你的代码

VS Code 的 TS 语言服务只检查被 tsconfig.json 显式包含的文件。即使文件在项目里，如果 include 漏了 "src/**/*"，或者 exclude 误写了 "**/*.test.ts" 却没加引号，整个目录就可能被忽略。

• "include" 推荐显式写成 ["src/**/*", "types/**/*"]，不要依赖默认行为
• 路径必须用正斜杠 /，且字符串要加引号，"src\**\*" 或 src/**/*（没引号）都会失效
• 检查是否有多个 tsconfig.json 并存——VS Code 按文件路径向上查找最近的一个，父目录的配置可能意外覆盖当前项目
• 文件开头有 // @ts-nocheck 会彻底禁用该文件检查，换成 // @ts-ignore 更可控

最常被忽略的一点：VS Code 的类型检查是“按需加载”的，它不会主动扫描整个项目，只响应打开的文件及其依赖链。所以即使 tsconfig.json 全对，某个 .ts 文件长期没打开，它的错误也不会出现在问题面板里——这不是 bug，是设计如此。