jsconfig.json比单纯装插件更关键，因为它引导vscode javascript语言服务正确解析模块路径、参与类型推断的文件及启用全局声明；缺失该配置导致跨文件导入、别名路径和第三方库方法链补全失效。
为什么jsconfig.json比单纯装插件更关键
很多用户装了一堆补全插件却收效甚微，根本原因是 VSCode 的 JavaScript 语言服务没被正确“引导”。jsconfig.json 就是这个引导文件——它告诉编辑器：你的模块路径怎么解析、哪些文件参与类型推断、是否启用全局声明。
不配 jsconfig.json，VSCode 默认只对当前文件做浅层分析，跨文件导入、别名路径（如 @/utils）、第三方库方法链调用基本无法补全。
- 必须放在项目根目录，且文件名不能拼错（不是
jsconfig.js或jsconfig.jsonc） - 最简有效配置只需
{"compilerOptions": {"baseUrl": ".", "paths": {}}}，哪怕paths空着也比没有强 - 如果用了 Webpack 别名，
paths必须和resolve.alias严格一致，否则补全失效 - 添加
"typeAcquisition": {"include": ["lodash"]}可自动拉取@types/lodash类型定义（前提是已安装）
@types/* 安装后没提示？检查这三处
装了 @types/react 却在 React. 后没补全，大概率不是插件问题，而是类型定义没被识别到。
- 确认
node_modules/@types/react目录真实存在，且不是空文件夹（常见于 pnpm/yarn v4+ 的硬链接问题） - 打开命令面板（
Ctrl+Shift+P），运行Developer: Toggle Developer Tools，看 Console 是否报Cannot find module '@types/react' - 检查
jsconfig.json中是否有"typeAcquisition": {"enable": true}—— 这个开关默认关闭，不手动开就只认显式 import 的类型
特别注意：require('react') 写法不会触发类型获取，必须用 import * as React from 'react' 或至少有 /// <reference types="react"></reference> 注释。
JSDoc 注释补全效果远超预期，但写法很挑剔
不用 TypeScript 也能获得精准补全，靠的是 JSDoc。但 VSCode 对注释格式极其敏感，一个空格或换行都可能导致失效。
-
/** @type {Array<string>} */</string>有效，/** @type{Array<string>} */</string>（@type和{之间无空格）无效 - 函数参数标注必须紧贴参数名：
function foo(/** @type {number} */ n) {}，写成function foo(n /** @type {number} */) {}就不识别 - 复杂对象推荐用
@typedef配合@type：/** @typedef {{id: number, name: string}} User */+/** @type {User} */ const user = {}; - DOM 元素类型可直接写
/** @type {HTMLDivElement} */，无需额外安装类型包
AI 补全插件（Copilot/Tabnine/Kite）和原生补全的冲突点
AI 插件不是替代原生补全，而是叠加在它之上。两者共存时，容易因触发时机或优先级混乱导致建议延迟、重复弹出甚至卡死。
- Copilot 默认禁用原生补全（
"editor.suggest.showSnippets": false），若想保留代码片段，需手动设为true - Tabnine 的
full line completion模式会劫持Enter键行为，与原生补全的Tab补全冲突，建议关闭该模式 - Kite 引擎必须常驻后台进程，如果任务管理器里看不到
kited进程，补全会完全失效（Windows/macOS/Linux 均适用） - 所有 AI 插件在大型 monorepo 项目中首次加载极慢，耐心等 30 秒以上再测试，不要误判为崩溃
真正难的从来不是装什么插件，而是让不同类型提示机制——静态分析、JSDoc、@types、AI 模型——在同一个文件里互不干扰地协同工作。这点连官方文档都没说透，得靠你手动调参、观察状态栏图标、查 DevTools 控制台日志才能摸清边界。
