VSCode默认支持Node核心模块基础补全，但require('fs').re无readFile提示，主因是缺少jsconfig.json配置和@types/node类型定义；jsconfig.json必须置于项目根目录以启用项目级语义分析，配合npm install --save-dev @types/node才能激活完整参数签名与跳转功能。

VSCode 默认就能对 Node.js 核心模块（如 fs、path、http）提供基础提示，但如果你的项目里 require('fs').re 按 Ctrl+Space 没弹出 readFile，说明语言服务没“认全”你的环境——问题不在插件，而在项目配置和类型定义缺失。

为什么 jsconfig.json 是必须的

VSCode 的 JavaScript 语言服务默认以“单文件模式”运行，不推断模块关系。加了 jsconfig.json，它才明白你用的是 CommonJS、哪些路径是可解析的、node_modules 在哪。没有它，哪怕装了所有 @types，补全也大概率只对全局变量生效。

• 必须放在项目根目录，文件名不能拼错（不是 jsconfig.js 或 .jsconfig.json）
• 内容可以极简，只要是个合法 JSON 就行，例如：

  { "compilerOptions": { "module": "commonjs", "target": "es2020" } }

• 如果项目用了 exports 字段或自定义 package.json#type，需额外加 "typeAcquisition": { "include": ["node"] }

@types/node 不装就一定没提示

Node.js 自身没有内置 TypeScript 类型，@types/node 就是它的“说明书”。VSCode 的 JS 语言服务会读取这个包来理解 fs.readFile 接收什么参数、返回什么 Promise 类型。

Rydberg Agent Node

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

下载

• 执行 npm install --save-dev @types/node（注意是 --save-dev，不是 --global）
• 不要用已废弃的 typings 工具，它和现代 npm/yarn/ pnpm 不兼容，容易报 dt~node not found
• 安装后检查 node_modules/@types/node/index.d.ts 是否存在，不存在说明安装失败
• 若用 pnpm，确保启用了 node-linker: hoisted 或在 .pnpmfile.cjs 中配置类型链接

第三方库提示失效的常见原因

装了 express 却没有 req. 后面的属性提示？不是 VSCode 问题，是类型声明没到位。

• 每个主流库基本都有对应 @types/xxx 包，比如 npm install --save-dev @types/express
• 有些小众库没官方 @types，可用 JSDoc 注释临时补全：

  /** @type {import('some-lib').SomeClass} */ let instance;

• 如果用了 ESM + type: module，但 jsconfig.json 还设 "module": "commonjs"，会导致路径解析失败，提示消失
• node_modules 被 .gitignore 或其他工具删掉后，VSCode 无法扫描类型文件，重启编辑器也不行，必须重新 npm install

最易被忽略的一点：VSCode 语言服务缓存有时会卡住旧配置。改完 jsconfig.json 或装完 @types/node 后，别只按 Ctrl+Shift+P → “Developer: Restart TS Server”，要关掉所有窗口再重开整个项目文件夹——否则它可能还在用上一次的语义分析快照。