Node.js变量类型注释定义问题：VS Code无法提供自动补全

以下是针对该问题的实用排查与解决步骤：

• 配置项目类型检查文件
  确保项目根目录存在jsconfig.json（JS项目）或tsconfig.json（TS项目），这是VS Code实现类型推断的核心依据。
  对于JS项目，可创建如下jsconfig.json：

  {
    "compilerOptions": {
      "module": "CommonJS",
      "target": "ES6",
      "checkJs": true
    },
    "include": ["**/*.js"],
    "exclude": ["node_modules"]
  }
  

  重点确认checkJs为true，开启JS文件的类型检查支持。

• 使用本地TypeScript版本

  1. 项目本地安装TypeScript：npm install typescript --save-dev
  2. 点击VS Code右下角状态栏的TypeScript版本号，切换为「工作区版本」，避免内置版本与项目依赖不兼容。

• 修正手动类型定义格式
  确保JSDoc类型注释格式正确，VS Code才能解析：

  • 内置模块类型示例：

    /** @type {import('http').IncomingMessage} */
    let req;
    

  • 自定义类型示例：

    /**
     * @typedef {Object} User
     * @property {string} username
     * @property {number} age
     */
    /** @type {User} */
    let currentUser;
    

• 重启TypeScript服务
  打开命令面板（Ctrl+Shift+P / Cmd+Shift+P），执行TypeScript: Restart TS Server，清除服务缓存，强制重新解析类型。

• 排查扩展冲突
  暂时禁用所有非必要的JS/TS相关扩展（如第三方格式化、语法检查插件），验证是否为扩展冲突导致类型识别失效。

• 安装Node.js类型声明
  执行npm install @types/node --save-dev，安装Node.js内置模块的类型声明文件，确保fs、http等模块的类型能被识别。

内容的提问来源于stack exchange，提问作者Arzex