VSCode TypeScript报红绝大多数是类型系统或语言服务配置问题，而非语法错误：需检查tsconfig.json是否就位、@types/vscode是否安装、TS版本是否设为Workspace、必要时重启TS Server。
VSCode里TypeScript代码报红，绝大多数不是语法错误，而是类型系统或语言服务配置问题——直接改代码往往无效，得调环境。
红波浪线来自 TypeScript 语言服务，不是 tsc 编译器
VSCode 的红色波浪线由内置的 tsserver 提供，它和你命令行运行 tsc 用的可能是两个 TypeScript 版本。常见表现：
- 代码能
tsc编译通过、也能正常运行，但编辑器里标红 - 报错如
Cannot find name 'vscode'、Property 'webview' does not exist on type 'ExtensionContext' - 错误位置飘忽（比如错行）、偶尔卡顿、重启 VSCode 后暂时消失
根本原因：语言服务没加载对的类型定义，或没识别到项目配置上下文。
检查 tsconfig.json 和 @types/vscode 是否就位
VSCode 的 TS 服务严重依赖 tsconfig.json 和类型声明包。缺一不可：
- 项目根目录必须有
tsconfig.json，哪怕最简配置也要包含：{"compilerOptions": {"target": "ES2020", "lib": ["ES2020", "WebWorker"]}} - 插件开发必须安装
@types/vscode：npm install --save-dev @types/vscode - 确认
node_modules/@types/vscode目录真实存在，且版本与当前 VSCode 兼容（例如 VSCode 1.89 对应@types/vscode@1.89.x） - 若用实验性 API，需在
tsconfig.json中显式启用："experimentalDecorators": true、"emitDecoratorMetadata": true
VSCode 正在用哪个 TypeScript 版本？
右下角点击 TypeScript 版本号，选 Use Workspace Version。如果没看到本地版本，说明：
- 项目没装
typescript：npm install --save-dev typescript - 没配
typescript.tsdk路径：在项目级.vscode/settings.json加{"typescript.tsdk": "node_modules/typescript/lib"} - 用了 pnpm/yarn 等包管理器，但
tsserver没正确解析node_modules结构（此时可尝试pnpm store prune或删node_modules重装）
插件开发中特别容易漏的点
写 VSCode 插件时，红波浪线常集中在 API 使用上，不是写错了，是类型没“接住”：
-
context.subscriptions.push()报错？因为subscriptions是只读数组 —— 改用context.subscriptions.push(disposable)即可，别试图.push到返回值 -
webview.postMessage(data)标红？确保data是基础类型（string、number、boolean）或满足Serializable结构（不能含函数、Date、RegExp等） - 自定义命令执行后类型丢失？
vscode.commands.executeCommand('xxx')返回any，需手动断言或封装成泛型函数 - 用到了新版本才加的 API（如
vscode.env.openExternal在 1.85+），但@types/vscode版本太低 → 升级类型包，或加运行时判断：if ('openExternal' in vscode.env)
最隐蔽的坑：你改了 tsconfig.json 或装了新依赖，但没重启 TS 服务 —— 按 Ctrl+Shift+P 输入 TypeScript: Restart TS server 才真正生效。
