vscode中node.js无语法提示的根本原因是缺少类型定义，需安装@types/node包并配置jsconfig.json：运行npm install --save-dev @types/node，再创建含"types": ["node"]的jsconfig.json文件。
VSCode 里 node 命令能用，但没语法提示？问题不在 VSCode
根本原因是：VSCode 本身不提供 Node.js API 的类型定义，它只负责展示——真正决定“能不能提示 require、process、__dirname 等是否合法”的，是 TypeScript 类型系统或 JSDoc + 类型声明文件。
如果你写的是纯 .js 文件（没开 TS），又没装类型声明，VSCode 就只能靠有限的内置 JS 语义推断，遇到 Node.js 内置模块时大概率“不认识”。这不是插件没装好，而是缺少 @types/node。
- 确认项目根目录下有没有
node_modules/@types/node：没有就说明类型声明缺失 -
package.json中没配"type": "module"或"type": "commonjs"，可能导致 VSCode 误判模块解析方式，进而影响提示 - VSCode 工作区启用了 JavaScript 语言服务（不是 TypeScript），但没启用自动类型获取（默认开启，但可能被禁用）
npm install @types/node 是最直接有效的解法
只要项目有 package.json（哪怕只是空的），运行这条命令就能让 VSCode 立刻识别 Node.js 全局变量和内置模块：
npm install --save-dev @types/node
注意：--save-dev 更合理，因为类型声明只在开发时需要；生产环境不需要。
ZenHeart zenlink 与 zenlink-mcp 为 OpenClaw，涵盖安装、MCP 注册、钩子接线、入站轮询及升级维护。
- 安装后，重启 VSCode 或按
Ctrl+Shift+P→ 输入Developer: Restart Language Server刷新 JS/TS 服务 - 如果项目用的是
yarn，对应命令是yarn add -D @types/node - 全局安装
npm install -g @types/node无效——类型声明必须在项目本地，VSCode 才会加载 - 版本要匹配：Node.js v20.x 对应
@types/node@20.x；用nvm use 18却装了@types/node@20，提示可能错乱或缺失
ESLint + @typescript-eslint 能补上“语法检查”这最后一环
光有智能提示还不够。比如你写了 fs.readfile()（少了个 S），提示可能标红，但 ESLint 才会明确报错 no-undef 或 @typescript-eslint/no-unsafe-call。
- 先装依赖：
npm install --save-dev eslint @typescript-eslint/parser @typescript-eslint/eslint-plugin
- 配
.eslintrc.cjs（注意是cjs，不是json，否则无法动态读取@types/node）：module.exports = {<br> parser: '@typescript-eslint/parser',<br> parserOptions: { ecmaVersion: 2022, sourceType: 'module' },<br> plugins: ['@typescript-eslint'],<br> extends: [<br> 'eslint:recommended',<br> 'plugin:@typescript-eslint/recommended'<br> ],<br> env: { node: true } // ← 这行必须有，否则不识别 Node.js 环境全局变量<br>}; - VSCode 需装官方
ESLint插件（ID:dbaeumer.vscode-eslint），并确保eslint.enable设为true
别忽略 jsconfig.json 或 tsconfig.json 的基础作用
哪怕你只写 JS，jsconfig.json 也是启用完整语言服务的关键开关。没有它，VSCode 可能退化为“带高亮的记事本”。
最小可用配置（放项目根目录）：
{<br> "compilerOptions": {<br> "target": "ES2020",<br> "module": "commonjs",<br> "lib": ["ES2020", "DOM"],<br> "types": ["node"]<br> },<br> "include": ["**/*.js"],<br> "exclude": ["node_modules"]<br>}
-
"types": ["node"]是核心——它告诉 JS 语言服务：“请加载@types/node” -
"lib": ["ES2020", "DOM"]中的DOM可删，Node.js 项目不需要浏览器 API 提示；留着也不会报错，但可能干扰判断 - 如果项目已存在
tsconfig.json，且含"typeRoots"或"types"字段，优先以它为准；jsconfig.json会被忽略
复杂点在于：类型声明、语言服务配置、ESLint 规则三者必须对齐。漏掉任意一环，都可能出现“提示有但检查不报错”，或“检查报错但提示不出现”的割裂体验。尤其当项目混用 require 和 import、同时支持 CJS/ESM 时，jsconfig.json 的 "module" 和 package.json 的 "type" 必须一致，否则连 __filename 都可能标黄报警。
