TypeScript项目中VSCode智能提示失效的根本原因是tsconfig.json配置错误或未被正确识别，导致语言服务无法加载上下文，表现为跳转失效、any泛滥、参数无提示等。
为什么 TypeScript 项目里 vscode 的智能提示突然不显示类型信息
根本原因通常是 tsconfig.json 配置错误或未被正确识别，导致 typescript-language-server 无法加载项目上下文。常见现象包括：跳转定义失效、any 泛滥、函数参数无提示、import 后无模块成员补全。
检查点如下：
- 确认项目根目录存在
tsconfig.json，且不是空文件或仅含{} - 运行
npx tsc --noEmit --watch，看终端是否报错（如Cannot find global type 'Array'表明lib或types缺失） - 在 VSCode 中按
Ctrl+Shift+P（macOS 为Cmd+Shift+P），输入Typescript: Select TypeScript Version，选Use Workspace Version（而非Bundled） - 检查
tsconfig.json中是否误删了"compilerOptions": { "moduleResolution": "node" }—— 缺失会导致路径映射（paths）失效
node_modules 里的类型声明没被识别，import 后无补全
VSCode 默认只读取 node_modules/@types/* 和包自身 types 字段指向的声明文件。如果某个包（如 axios）没提供类型，或你用了非标准类型包（如 @types/xxx 未安装），补全就会中断。
解决方法：
- 先执行
npm install --save-dev @types/node（几乎所有 Node 项目都需要） - 对常用库补装类型：
npm install --save-dev @types/react @types/react-dom @types/jest - 若使用了
pnpm，确保启用了node_modules/.pnpm下的类型链接：在tsconfig.json中添加"typeRoots": ["node_modules/@types", "src/types"] - 检查包是否有内建类型：运行
npm view axios types，若返回undefined，说明需手动装@types/axios
JavaScript 文件中 jsconfig.json 不生效，/** @type */ 注释也没提示
JS 项目依赖 jsconfig.json 激活 TS 语言服务，但很多人忽略它必须满足两个硬性条件：存在且位于工作区根目录；内容至少包含 {"compilerOptions": {"allowJs": true}}。
典型错误配置：
{
"compilerOptions": {
"target": "ES2020",
"module": "commonjs"
}
}上面缺少 "allowJs": true，VSCode 就不会为 .js 文件启用类型检查和补全。正确写法：
{
"compilerOptions": {
"allowJs": true,
"checkJs": true,
"target": "ES2020",
"module": "commonjs",
"baseUrl": ".",
"paths": {
"@/*": ["src/*"]
}
},
"include": ["**/*.js", "src/**/*"],
"exclude": ["node_modules"]
}注意：checkJs 开启后，/** @type {string} */ 这类 JSDoc 注释才能触发类型校验与补全。
重启 TS Server 后仍无效：如何定位是插件还是配置问题
VSCode 的 TS 插件本质是调用本地 tsserver 进程，很多“失效”其实是进程卡死或加载了错误的配置上下文。
快速诊断步骤：
- 按
Ctrl+Shift+P→ 输入Developer: Toggle Developer Tools，切换到 Console 标签页，观察是否有TypeError: Cannot read property 'getProgram' of undefined类错误 - 打开任意
.ts文件，按Ctrl+Shift+P→Typescript: Restart TS Server，再看状态栏右下角是否显示TS 5.3.3（版本号） - 在文件中右键 →
Go to Project Configuration，确认跳转的是你预期的tsconfig.json，而不是父目录或node_modules里的某份 - 临时禁用所有插件（除
ESLint、Prettier、TypeScript官方扩展外），再逐个启用，排查冲突（尤其注意Vetur、Vue - Official在非 Vue 项目中可能劫持语言服务）
最常被忽略的一点：工作区设置了 "typescript.preferences.includePackageJsonAutoImports": "auto"，但项目里没有 package.json，此时整个自动导入链会静默降级——补全菜单里就只剩基础关键字。
