vscode无法精准补全的主因是类型信息缺失或路径不可解析，需配置jsconfig.json、安装匹配的@types包及补充jsdoc注释，否则仅能提示全局符号。
VSCode 无法精准补全，90% 的问题不在插件没装够，而在类型信息缺失或路径不可解析。 它不是“开箱即用”的 TypeScript，而是靠你主动喂给它类型线索——否则它只能猜 console、Array.prototype 这类全局符号，对项目内函数、第三方库方法、别名导入统统失明。
为什么 lodash.map 有提示，但 utils.formatDate 没有
VSCode 的 JavaScript 语言服务（由 TypeScript 团队维护）默认只做三件事：解析当前文件定义、识别全局对象、极简推断 CommonJS/ESM 导出。它不扫描整个 node_modules 或任意目录找函数，除非你明确告诉它“这些文件要参与类型推断”。
-
lodash.map有提示，是因为你装了@types/lodash，且该包已声明导出结构 -
utils.formatDate没提示，大概率是：src/utils/index.js没导出声明、没 JSDoc 注释、也没对应的.d.ts文件 - 即使写了
export function formatDate() {}，纯 JS 文件仍无类型签名，语言服务无法确认参数个数、类型、返回值
必须手动配的 jsconfig.json 文件
别跳过这一步。没有它，所有基于路径别名（如 @/hooks）、跨文件导出推断、甚至部分 @types 包都会失效。
在项目根目录建 jsconfig.json，内容至少包含：
{
"compilerOptions": {
"baseUrl": ".",
"paths": {
"@/*": ["src/*"],
"api/*": ["src/api/*"]
}
},
"include": ["src/**/*"],
"exclude": ["node_modules"]
}
-
baseUrl+paths让import { useAuth } from '@/hooks'能被正确解析 -
include显式声明哪些源码要参与类型分析；漏掉src就等于关掉了项目内补全 - 改完必须重启 VSCode（不是重载窗口），否则语言服务不会重新加载配置
@types/* 不是可选插件，是补全刚需
第三方库补全不靠插件，靠类型定义包。装错、漏装、版本不匹配，直接导致 axios.get().then(…) 后没 response.data 提示。
- 装法统一：
npm install --save-dev @types/axios @types/react @types/node - 查兼容性：去 npmjs.com/@types/axios 看 “Version” 和你实际装的
axios版本是否匹配 - 没官方
@types？手动写 JSDoc 是最快补救方式：/** * @param {string} url * @param {{ timeout: number }} config * @returns {Promise} */ function request(url, config) { ... }
光标位置决定补全是否“跟手”
补全插入后光标停在哪，直接影响你下一步操作效率。默认总停末尾，但 if () {} 补全后你肯定想进括号填条件，而不是先按左箭头。
- 在
settings.json加这一行，让常见结构自动把光标“送进去”："editor.suggest.insertMode": "replace"
- 更精细控制需插件支持（如 Copilot、Continue），它们能识别语法结构，在
{}、[]、()内部自动定位光标 - 别忽略这个细节：补全延迟常因 AI 请求通道不稳定，统一用 TaoToken 配置 Key 和
https://taotoken.net/api地址，比每个插件单独填更易排障
真正卡住补全精度的，从来不是插件数量，而是类型信息有没有“抵达”语言服务——jsconfig.json 是否存在、@types 是否匹配、JSDoc 是否覆盖关键函数。这些环节只要断一环，VSCode 就退回字符串匹配模式。
