必须锁定工作区TypeScript版本并重启TS Server，否则因内置与本地版本不一致会导致tsserver反复重启、类型推导错乱、补全卡顿；需在.vscode/settings.json中配置typescript.tsdk和enablePromptUseWorkspaceTsdk，并删除tsconfig.json中的files字段，改用include/exclude精确控制文件范围。

确认当前 TypeScript Server 实际使用版本

状态栏右下角点击 TypeScript 版本号，看到的是 Bundled version: 5.2.2 还是 Workspace version: 5.4.5？前者说明你正在用 VSCode 自带旧版服务，哪怕 node_modules/typescript 已安装 5.4.5 也无效。命令面板运行 TypeScript: Select TypeScript Version 后若没真正选中 “Use Workspace Version”，只是“看起来切换了”——这一步几乎总被跳过。

必须在 .vscode/settings.json 中硬编码 typescript.tsdk

仅靠命令面板切换不可靠，尤其在多根工作区或 monorepo 中容易回退。必须写死路径：

{
  "typescript.tsdk": "./node_modules/typescript/lib",
  "typescript.enablePromptUseWorkspaceTsdk": true
}

typescript-dev

使用 Vite 8、React 19、Tailwind CSS v4、shadcn/ui、Biome、Vitest 和 Hono 构建全栈 TypeScript 应用，涵盖前端（Vite/Rolldown 构建 + 开发）...

下载

• ./node_modules/typescript/lib 必须存在（即已执行过 npm install --save-dev typescript）
• 若用 pnpm，路径仍是 ./node_modules/typescript/lib，硬链接不影响有效性
• 删掉 tsconfig.json 中的 files 字段——它会绕过所有 include/exclude 规则，强行加载 node_modules/react/index.d.ts 这类不该进类型检查的文件

tsconfig.json 关键配置项不能缺

以下不是“可选优化”，而是大型 TS 项目不卡顿的底线：

• "skipLibCheck": true —— 关闭对 node_modules 中类型声明的检查，提速最显著
• "composite": true + "declarationMap": false —— 启用增量编译，避免每次重算整个项目
• "include" 显式列出源码路径（如 ["src/**/*", "types/**/*.d.ts"]），严禁留空或写 ["**/*"]
• 检查 "typeRoots" 是否指向巨量目录（如 ["../shared-types"]），应精简为 ["node_modules/@types"]

editor.quickSuggestionsDelay 是延迟主因，不是 suggestDelay

很多人调了 editor.suggestDelay 却没效果，因为真正控制「停下输入到弹出提示框」的是 editor.quickSuggestionsDelay，默认值是 1000 毫秒。

• 设为 0 表示立即触发（注意：仍需语言服务响应时间）
• 设为 200～300 更平衡，既避免误触又不显迟滞
• 支持语言专属配置，例如只对 JS 加快："javascript.editor.quickSuggestionsDelay": 200
• 该设置会被工作区 .vscode/settings.json 或语言专属设置覆盖，优先级高于全局设置

改完配置后不手动执行 Restart TS Server，等于白改。Ctrl+Shift+P 输入并运行它，才是唯一生效验证点。