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": "ES2025",
    "module": "commonjs"
  }
}

上面缺少 "allowJs": true，VSCode 就不会为 .js 文件启用类型检查和补全。正确写法：

{
  "compilerOptions": {
    "allowJs": true,
    "checkJs": true,
    "target": "ES2025",
    "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，此时整个自动导入链会静默降级——补全菜单里就只剩基础关键字。