require('fs')后无提示，是因为vscode未加载node.js类型定义：需安装@types/node、配置jsconfig.json（含"checkjs":true等字段）、重启ts服务，并确保以文件夹形式打开项目。
为什么 require('fs') 后输 .r 没提示？
不是 VSCode 坏了，是它根本没加载 Node.js 的类型定义。Node.js 自身 API（如 fs、path、process）的补全和跳转，完全依赖 @types/node 这个包提供的类型声明文件。
常见错误现象：输入 const fs = require('fs'); 后敲 fs.r，无任何提示；Ctrl+Click fs.readFile 跳不到源码；Hover 看不到函数签名。
- 必须在项目根目录运行
npm install --save-dev @types/node（注意是--save-dev，不是--save；虽然两者都可能生效，但语义更准） - 确认
node_modules/@types/node目录真实存在，且里面有index.d.ts - 如果用了 pnpm/yarn 2+，确保没有启用
node-linker: hoisted导致@types被提升到错误位置——可临时改用pnp或hoisted+ 显式pnpm install -D @types/node - 装完不重启 VSCode，补全不会生效；推荐用
Ctrl+Shift+P → Developer: Restart TS Server，比全量重启快
jsconfig.json 必须存在且含哪些字段？
没有 jsconfig.json，VSCode 就把你的 JS 当纯文本处理，连 require('./utils') 后的 utils. 都不会提示——这不是插件问题，是语言服务“失明”。
纯 JavaScript Node.js 项目（非 TypeScript），必须在项目根目录手动创建 jsconfig.json，内容至少包含：
{
"compilerOptions": {
"module": "commonjs",
"target": "es2020",
"allowSyntheticDefaultImports": true,
"esModuleInterop": true,
"checkJs": true,
"maxNodeModuleJsDepth": 2
},
"include": ["**/*.js"],
"exclude": ["node_modules"]
}
-
"checkJs": true是关键：它让 TypeScript 语言服务主动检查 JS 文件中的 JSDoc 类型注释和模块结构 -
"maxNodeModuleJsDepth": 2让语言服务深入node_modules查找.d.ts（比如@types/express） -
"include"必须覆盖你所有源码路径，写成["src/**/*.js"]比["**/*.js"]更安全，避免误扫构建产物 - 删掉这个文件，补全立刻退化——这是验证它是否起作用的最快方式
第三方库（如 express）没提示？
VSCode 不会自动为 express 这类纯 JavaScript 库生成类型，它只读取已安装的 @types/xxx 包。没装对应类型定义，app.get() 就永远只有基础字符串补全。
- 先确认已运行
npm install express，再运行npm install --save-dev @types/express - 同理：
@types/lodash、@types/axios、@types/node-cron……每个库都要单独配@types/包 - 注意命名一致性：
npm install @types/koa-router对应koa-router，不是@types/koa__router（双下划线是 npm 内部用的，@types用短横线） - 如果库本身带内建类型（如
zod、fastify），则无需@types，但需确保其types字段在package.json中正确指向dist/index.d.ts
Ctrl+Click 跳不到 require('./xxx') 的文件？
跳转失败通常不是路径写错了，而是 VSCode 没法解析模块解析规则。默认情况下，它只认 ./xxx.js、./xxx/index.js，对 ./xxx（无后缀）或自定义扩展名（如 .cjs）直接放弃。
- 在
jsconfig.json的compilerOptions里加"resolveJsonModule": true和"moduleResolution": "node"，强制启用 Node.js 模块解析逻辑 - 确保
require('./utils')对应的文件真实存在，且命名规范：优先是utils.js或utils/index.js；如果是utils.mjs，需额外设"module": "esnext"并配合"type": "module"在package.json中 - 路径别名（如
@/lib）必须在jsconfig.json中用"baseUrl"和"paths"显式声明，否则跳转和补全都会失效 - 右下角语言模式必须是
JavaScript，不是Plain Text或JSON；点一下右下角手动切换
最易被忽略的一点：补全和跳转高度依赖当前打开的文件是否属于该工作区上下文。不要只打开单个 .js 文件，一定要用 File → Open Folder 打开整个项目根目录——否则 jsconfig.json 和 node_modules 全部失效。
