VSCode内置TypeScript语言服务，额外安装TS插件易引发冲突、拖慢响应、导致类型提示失效；应禁用冗余插件、重启TS Server，并确保状态栏显示Workspace版本、TS Server就绪且无配置警告。
VSCode 本身不依赖“TS 插件”来支持 TypeScript——它内置了完整的 TypeScript 语言服务，装额外插件反而容易冲突、拖慢响应、甚至让类型提示失效。
为什么装了 TypeScript 插件反而更糟
很多用户搜“VSCode 安装 TS 插件”，结果装了 TypeScript and JavaScript Language Features（其实已预装）、TypeScript Hero 或 Auto Import，接着发现：Ctrl+Click 跳转错位、import 自动补全路径混乱、重命名不跨文件、保存后 import 顺序被重排。
- VSCode 内置的 TS 服务是唯一与
tsc行为对齐的语言服务器，第三方插件无法真正复现编译器语义 -
TypeScript Hero等插件会劫持自动导入逻辑，绕过tsconfig.json的baseUrl/paths配置，直接按文件系统猜路径 -
Auto Import在启用了"esModuleInterop": true的项目里，可能把import fs from 'fs'错误补全成import * as fs from 'fs' - 禁用所有非必要插件后，执行
Ctrl+Shift+P → TypeScript: Restart TS server，往往立刻恢复跳转和提示
真正要确认的三个状态栏指标
打开任意 .ts 文件，右下角状态栏必须同时满足这三点，才算 TS 环境就绪：
- 显示
TypeScript X.Y.Z (Workspace)（不是Bundled或Global）——点击版本号选Use Workspace Version - 旁边显示
TS Server: Ready（不是Starting...或报错图标） - 没有黄色感叹号提示 “No tsconfig.json found” 或 “Cannot find module”
如果任一不满足，tsc --noEmit 能跑通但 VSCode 不报错，就是典型“假正常”——编辑器根本没读你的配置。
立即学习“前端免费学习笔记（深入）”；
PigX UI Pro 前端开发指南 - Vue 3 + TypeScript + Element Plus。当用户提到 PigX UI、PigX 前端、lgb-mgui 项目、Vue 3 企业级后台开发、Element Plus 后台开发时使用此技能。
tsconfig.json 必须存在的最小字段集
只靠 tsc --init 生成的默认配置远远不够。前端项目至少要显式写明以下字段，否则路径别名、JSX、ESM 模块解析全崩：
"compilerOptions": { "target": "ES2020", "module": "ESNext", "lib": ["ES2020", "DOM"], "moduleResolution": "bundler", "strict": true, "skipLibCheck": false, "resolveJsonModule": true, "jsx": "react-jsx", "baseUrl": "./", "paths": { "@/*": ["src/*"] } }-
"include": ["src/**/*"]—— 缺失会导致src/utils.ts里的类型不被其他文件感知 -
"exclude": ["node_modules", "dist"]—— 不排除dist，TS Server 可能反复解析已编译 JS，卡顿或报错
注意："moduleResolution": "bundler" 是 TS 5.0+ 前端项目的刚需，旧值 "node" 或 "node16" 会导致 Vite/Webpack 别名失效，且 VSCode 不识别 import.meta.env 类型。
调试时 sourceMap 失效的硬核原因
断点打在 .ts 文件上却停不住？90% 是因为没配对两处：
-
tsconfig.json中必须有"sourceMap": true（仅此一项不够） -
.vscode/launch.json的program字段必须指向编译后的.js文件，例如"program": "${workspaceFolder}/dist/index.js" - 若用 Vite 开发服务器，不要配
launch.json，改用浏览器 DevTools 的sources面板——Vite 自动生成 sourcemap 并注入，VSCode 调试器反而不认
最容易被忽略的是：outDir 和 rootDir 必须匹配。比如 "rootDir": "src" 但 "outDir": "build"，而实际代码在 src/pages/Home.tsx，编译后路径变成 build/pages/Home.js，此时 sourceMap 里的 sources 字段若写成 ["../src/pages/Home.tsx"]，VSCode 就找不到原始文件。
