VSCode 对 Node.js 核心模块补全失效的主因是项目配置或语言服务异常：缺少 jsconfig.json/tsconfig.json、文件模式错误、TS 服务未运行、未安装 @types/node 或路径配置不当。

VSCode 默认就能对 Node.js 核心模块（如 fs、path、http）提供基础补全，但若提示缺失、参数不显示或跳转失效，问题几乎都出在项目配置或语言服务状态上，而非插件没装够。

为什么 require('fs') 后按 . 没反应？

这不是 VSCode “不支持”，而是它没把当前文件识别为有效的 JavaScript/Node.js 上下文。常见原因包括：

• 项目根目录缺少 jsconfig.json 或 tsconfig.json，导致语言服务以“无类型 JS”模式运行，放弃语义分析
• 文件语言模式被误设为 Plain Text 或 JavaScript React（尤其在 .js 文件里写 Node 逻辑时）
• 右下角状态栏显示 JavaScript，但实际未加载 TypeScript 语言服务（可按 Ctrl+Shift+P → 输入 TypeScript: Restart TS server 强制重启）
• 写了 import fs from 'fs' 却没启用 ESM 支持（Node v14+ 需 "type": "module" 在 package.json 中，否则 fs 不会被正确解析）

fs.readFile 有提示但没参数签名？

Node.js 核心模块的类型定义由 @types/node 提供，VSCode 的 TypeScript 服务必须能加载它。没提示，大概率是类型包没装或路径没对上：

Rydberg Agent Node

使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r

下载

• 运行 npm install --save-dev @types/node（注意：不是 @types/nodejs，后者已废弃）
• 确保 jsconfig.json 中 "compilerOptions" 至少包含 "lib": ["es2020", "node"]，否则 @types/node 的全局声明不会被激活
• 如果用了 checkJs: true，还要加 "allowJs": true，否则 .js 文件里的 JSDoc 类型注释不会被读取
• 检查 node_modules/@types/node 是否真实存在且非空；某些 pnpm/yarn 瘦身模式会跳过 @types 目录

路径补全和 Ctrl+点击跳转失效？

VSCode 对 require('./utils') 或 import { helper } from '../lib' 的路径解析，完全依赖 jsconfig.json 的 baseUrl 和 paths，而不是文件系统扫描：

• 必须在项目根目录新建 jsconfig.json，内容至少含：

  {
    "compilerOptions": {
      "baseUrl": ".",
      "lib": ["es2020", "node"]
    },
    "include": ["**/*.js"],
    "exclude": ["node_modules"]
  }

• 删掉 "baseUrl": "." 或把它写成 "./src" 但源码不在该路径下，路径补全立即变哑
• 修改后务必重启 TS 服务（Ctrl+Shift+P → TypeScript: Restart TS server），否则改动不生效
• 多根工作区中，每个子文件夹需独立 jsconfig.json，父级配置不会继承

最常被忽略的是：补全质量不取决于你装了多少“智能提示插件”，而取决于 jsconfig.json 是否存在、@types/node 是否装对、TS 服务是否真正运行——三者缺一，fs.promises 就永远只显示为一个变量名，不会展开方法列表。