vscode的javaScript智能提示依赖jsconfig.json/tsconfig.json配置、JSDoc注释、@types声明包及最新语言服务。缺一即导致提示退化为字符串匹配，需逐项验证类型信息链。
VSCode 的 javascript 智能提示本身不“自带”强类型能力，它依赖 JavaScript language service + 类型推断 + JSDoc / 类型声明文件（.d.ts）协同工作。没有合理配置或类型信息支撑时，提示会退化为简单字符串匹配，甚至频繁失灵。
为什么 jsconfig.json 或 tsconfig.json 是前提
VSCode 的 JS 语言服务默认以“当前文件是否在项目根目录下有配置文件”来决定是否启用模块解析、路径别名支持和全局类型合并。没有 jsconfig.json，import 路径跳转失败、node_modules 中带 JSDoc 的包（如 lodash、axios）无法提供参数提示。
-
jsconfig.json必须包含{"compilerOptions": {"allowJs": true, "checkJs": false}}，否则 JS 文件被忽略 - 若项目混用 TS，直接放
tsconfig.json更稳妥（即使无.ts文件），VSCode 会自动 fallback 到 JS 支持 -
"baseUrl"和"paths"需显式声明才能让路径别名（如@/utils）被识别并触发补全
JSDoc 注释不是可选，而是关键类型来源
纯 JS 项目里，@param、@returns、@type 是 VSCode 推断函数签名的最主要依据。不写 JSDoc，哪怕函数逻辑清晰，参数名和返回值也常显示为 any。
-
/** @param {String} name */ function greet(name) {}→ 输入greet(时提示name: string -
/** @type {import('axios').AxiosInstance} */ const api = axios.create(...)→api.get才有完整方法提示 - 避免
/** @param {*} x */，这等价于放弃类型提示
第三方库提示失效？大概率缺了 @types/* 或未启用 checkJs
像 moment、react 这类无内建 JSDoc 的库，VSCode 只能靠社区维护的类型声明包（@types/moment）提供提示。但装了也不一定生效——需要明确告诉语言服务“请检查 JS 文件中的类型错误”。
立即学习“Java免费学习笔记（深入）”；
- 安装对应
@types/*包后，必须在jsconfig.json中设"checkJs": true（或tsconfig.json中同名选项） -
"checkJs": true会触发类型检查，同时也激活对@types的加载；不开启则只做基础语法提示 - 注意：开启后若代码存在隐式
any，会报红，这是预期行为，不是 bug
插件不是越多越好：JavaScript and typescript Nightly 常比默认内置更稳
VSCode 内置的 JS 语言服务版本固定，跟不上 TypeScript 官方迭代速度。某些新语法（如装饰器、Array.prototype.toReversed()）或 React 18 的 use Hook 提示，在旧服务中直接不出现。
- 卸载所有 JS/TS 相关插件，仅启用官方
JavaScript and TypeScript Nightly（由 TypeScript 团队直更） - 该插件会覆盖内置服务，且自动识别
jsconfig.json和tsconfig.json，无需额外配置 - 如果用了
Volar（vue 场景），确保它未接管 .js 文件 —— 检查右下角语言模式是否仍为JavaScript，而非Vue
真正卡住智能提示的，往往不是 VSCode 本身，而是类型信息断层：JSDoc 没写、配置没生效、@types 没装或没被读取、语言服务版本滞后。逐项验证这四点，比调字体大小或换主题更能解决问题。