Node.js代码无提示的根本原因是VSCode语言服务未正确识别Node环境，需同时满足三点：项目根目录存在package.json、node_modules完整且含@types包、jsconfig.json配置正确并位于根目录。
为什么Node.js代码没提示？先查这三件事
VSCode里写require('fs')没补全、点进express看不到方法列表，根本不是插件没装对，而是语言服务“不认识”你的项目。核心就三点：package.json是否存在、node_modules是否完整、jsconfig.json是否配置正确。缺一不可。
-
package.json必须存在——哪怕只是npm init -y生成的空壳，它是VSCode识别Node项目的起点 -
node_modules不能是空的或损坏的——npm install express后，@types/express也要装（npm install --save-dev @types/express），否则只认函数名，不认参数和返回值 -
jsconfig.json必须在项目根目录——没有它，VSCode默认按浏览器环境解析，__dirname、process.env这些Node专属变量就无法被识别
jsconfig.json怎么写才生效
纯JavaScript项目不需要TypeScript编译，但jsconfig.json是让VSCode语言服务理解Node上下文的关键。它不是可选配置，是刚需。
- 最简可用配置必须包含
"compilerOptions"里的"module"和"target"：设"module": "commonjs"（Node默认模块系统），"target": "es2020"（兼容大多数Node版本） - 如果项目用了
baseUrl或paths做路径别名（比如@/utils），必须在jsconfig.json里显式声明，否则跳转和补全全部失效 - 不要用
tsconfig.json替代——即使你没写TS，jsconfig.json才是JS项目的官方入口；VSCode看到tsconfig.json会优先走TS解析逻辑，反而绕过JS增强特性
示例（保存为项目根目录下的jsconfig.json）：
{
"compilerOptions": {
"module": "commonjs",
"target": "es2020",
"baseUrl": ".",
"paths": {
"@/*": ["./src/*"]
}
},
"include": ["**/*.js"],
"exclude": ["node_modules"]
}@types包不是“锦上添花”，是补全的基础设施
第三方库如axios、lodash本身不带类型定义，VSCode光靠require()只能推导出any，补全就只剩个名字。真正让参数提示、链式调用、属性列表出现的，是@types包。
- 安装必须带
--save-dev：例如npm install --save-dev @types/node @types/express——@types/node是基础，提供global、Buffer等全局对象定义 - 注意版本对齐：
@types/express要匹配你装的express主版本（如express@4.x对应@types/express@4.x），错配会导致方法缺失或类型报错 - 遇到无
@types的库（比如小众npm包），临时方案是用JSDoc标注：/** @type {import('xxx').SomeClass} */ const instance = ...，比手动查文档快得多
重启和重载不是仪式感，是必要操作
VSCode的语言服务缓存很顽固。改完jsconfig.json、装完@types、甚至删了node_modules重装，不强制刷新，提示大概率不会更新。
- 快捷键
Ctrl+Shift+P（macOS为Cmd+Shift+P），输入Developer: Reload Window并执行——这是最可靠的方式 - 别信“保存后自动生效”：VSCode不会监听
node_modules变化，也不会实时重读jsconfig.json - 如果重载后仍无效，打开命令面板运行
JavaScript: Start JavaScript Language Service，强制拉起服务（偶尔服务卡死）
真正容易被忽略的，是jsconfig.json的路径——它必须严格位于项目根目录，且文件名大小写完全匹配（jsconfig.json，不是JsConfig.json或jsconfig.JSON）。Windows下可能不敏感，Linux/macOS会直接静默失效。
