VSCode的JavaScript智能提示需依赖jsconfig.json/tsconfig.json配置、JSDoc注释、@types声明包及语言服务协同工作；缺一即退化为字符串匹配，无法实现TypeScript级别精准提示。
JavaScript 代码在 VSCode 中默认有基础补全，但想获得接近 TypeScript 级别的精准提示（比如第三方库方法、参数结构、返回值），光靠内置功能远远不够。关键不是“装插件就行”，而是明确每类补全的来源和边界——否则容易反复折腾却收效甚微。
为什么原生 JavaScript 补全总是“猜不准”
VSCode 的 JavaScript 语言服务（由 TypeScript 团队维护）本身能力很强，但它严重依赖类型信息。纯 JS 没有显式类型声明，所以它只能靠：
- 当前文件内已定义的变量/函数
- 全局对象（window、console、Array.prototype 等）
- 极有限的 CommonJS/ESM 模块推断
一旦涉及 lodash、axios 或项目内未导出的工具函数，它就基本“失明”。这不是插件没装好，是 JS 语言特性决定的。
必须装的三类插件及其分工
-JavaScript (ES6) code snippets：只提供固定代码块（如 for → for (let i = 0; i ），不解决类型提示问题
- <code>@types/* 包（通过 npm 安装）：这才是让 lodash、node、express 等库产生智能提示的真正来源，例如：npm install --save-dev @types/lodash-
ESLint + Prettier：不提供补全，但能暴露类型错误（比如调用不存在的方法），间接帮你验证补全是否可信
不要指望一个插件包打天下。@types 是类型定义，ES6 snippets 是语法糖，ESLint 是校验器——它们各干各的活。
jsconfig.json 是绕不开的配置文件
即使装了 @types，如果项目结构复杂（比如用了别名路径 @/utils），VSCode 依然找不到模块。这时必须手动创建 jsconfig.json：
{
"compilerOptions": {
"baseUrl": ".",
"paths": {
"@/*": ["src/*"]
}
},
"include": ["src/**/*"],
"exclude": ["node_modules"]
}
- baseUrl 和 paths 让导入路径可解析
- include 显式告诉语言服务哪些文件要参与类型推断
- 缺少这个文件，import { helper } from '@/utils' 就永远不会有 helper. 的提示
常见失效场景和对应解法
-node_modules 里装了 @types，但提示仍不出现：检查 jsconfig.json 是否存在且路径匹配，重启 VSCode（不是重载窗口）
- 写 axios.get 有提示，但 .then() 后没 response.data 提示：说明 @types/axios 版本过旧或与实际 API 不兼容，尝试升级或手动加 JSDoc 注释
- 第三方库（如 WPS JS SDK）官方提供了 .d.ts 文件：直接把文件放进项目 types/ 目录，并在 jsconfig.json 的 typeRoots 中声明
- 插件图标显示正常，但按 . 没反应：确认当前文件右下角语言模式是 JavaScript（不是 Plain Text 或 JSON）
真正的智能补全，从来不是“开箱即用”的魔法，而是类型定义、路径配置、语言服务三者对齐的结果。漏掉任意一环，都会卡在“好像装了，但就是不提示”的状态里。
