补全错误源于语言服务器对项目结构或类型信息理解偏差，根源在配置或环境而非代码本身；常见于TS/JS未配tsconfig、Python解释器路径错误、C++缺失compile_commands.json等场景。
补全提示错误（比如给出不存在的函数、参数类型错乱、跳转定义到错误位置）不是“提示太智能”，而是语言服务器对项目结构或类型信息的理解出了偏差——根源几乎都在配置或环境层面，而非代码本身。
为什么补全建议和实际类型对不上
常见现象：写 arr.map 时提示里出现 map 的重载签名，但点进去却跳到 Array.prototype.map 的声明，而你实际用的是 Lodash 的 map；或者 useState 提示返回 [any, any]，而不是 [T, Dispatch<setstateaction>>]</setstateaction>。
- TS/JS 项目没配
tsconfig.json或jsconfig.json，tsserver 只能做基础语法分析，无法推断模块路径和类型来源 -
typescript.tsdk指向了全局 TypeScript，但项目依赖的是node_modules/typescript里的旧版，版本不一致导致类型解析错位 - Python 项目中
python.defaultInterpreterPath指向了没装qiskit或pydantic的环境，Pylance 就会按空环境建模，补全自然漏掉关键方法 - C++ 项目缺失
compile_commands.json，clangd 不知道头文件搜索路径，#include补全和符号跳转就不可靠
补全列表里混进无关项或重复项
比如输入 fetch，补全框里同时出现原生 fetch、axios.get、useQuery、甚至你项目里某个叫 fetchData 的函数——这不是功能强，是语言服务没过滤上下文。
- 多个 AI 插件（如 Copilot + 通义灵码 + CodeWhisperer）同时启用，它们都往补全列表里塞建议，VS Code 默认不做去重或优先级排序
- 工作区
.vscode/settings.json里写了"editor.suggest.showMethods": true，但没关"editor.suggest.showWords"，导致变量名、函数名、字符串字面量全混在一起 - Pylance 启用了
python.analysis.extraPaths，把测试目录或旧项目路径加进来了，里面同名模块污染了类型索引 - Vue 文件选成了
Vue HTML而非Vue，Volar 不接管，SFC 中的defineProps补全被当成普通 JS 函数处理，签名丢失
补全弹出但内容明显“过时”或“不全”
比如改了 interface User 加了新字段，但 const u: User = {} 里按 Ctrl+Space 还是旧字段；或者 import 补全里看不到刚装的 zod 包。
- 语言服务器缓存未刷新：执行命令
Developer: Restart Language Server（不是重启窗口），强制重载项目语义图 - Python 项目中
pyproject.toml或setup.py缺失，Pylance 不会主动扫描site-packages，第三方库补全需手动加python.analysis.extraPaths - TS 项目里
tsconfig.json的"include"没覆盖新文件夹，或"exclude"错误排除了src/**/*，导致新增模块不被索引 - VS Code 的
CachedData目录损坏（尤其 macOS 上~/Library/Caches/com.microsoft.VSCode.ShipIt/），清掉后重启可恢复类型推导一致性
真正难调的不是“补全出不来”，而是“补全出来了，但不对”——这时候别急着换插件，先看输出面板里对应语言服务器的日志，找 Failed to resolve、Skipping file、Using fallback types 这类线索。它们比 UI 上的波浪线诚实得多。
