VSCode代码自动补全需同时满足三条件：语言服务器已加载、文件语言模式正确、项目有可解析的类型/路径上下文；缺一则仅剩关键词拼写建议，无法实现函数签名提示或跨文件跳转。
VSCode 的代码自动补全（IntelliSense）不是装完插件就自动“变聪明”的，它必须满足三个硬性条件：语言服务器已加载、当前文件被识别为正确语言模式、项目有可解析的类型/路径上下文。缺一不可，否则你看到的只是关键词拼写建议，而不是函数签名、参数提示或跨文件跳转。
确认语言服务器是否真在运行
很多人调了一堆 editor.* 设置却没效果，根源是语言服务压根没启动。这不是配置问题，而是前置状态没达标。
- 看右下角状态栏：显示必须是
TypeScript、Python、Rust等具体语言名，不能是Plain Text或Unknown - 按
Ctrl+Shift+P→ 输入Change Language Mode→ 手动选对语言（尤其.vue、.jsx、.pyi这类后缀容易错配） - 写一行明显报错的代码，比如
const a: number = 'hello';，没红色波浪线？说明 TypeScript 服务没接管；Python 中np.arra不提示array？大概率Pylance没加载 - 打开
输出面板（Ctrl+Shift+U），切换到Python或TypeScript Server日志，搜Starting或error
必须配置 jsconfig.json 或 tsconfig.json（JS/TS 项目）
没有这个文件，VSCode 就当你的项目是“单个 JS 文件”，所有 import 别名（如 @/utils）、模块路径推导、类型提示都会失效——补全是盲猜，跳转是摆设。
- 在项目根目录新建
jsconfig.json（纯 JS）或tsconfig.json（TS），内容至少含compilerOptions.baseUrl和include - 别名补全必须配
paths，例如："@/*": ["src/*"]，否则import Button from '@/ui/Button'后按.不会出方法列表 -
include要明确覆盖源码目录，比如"include": ["src/**/*"]，漏掉就索引不到 - 改完立刻按
Ctrl+Shift+P→TypeScript: Restart TS server，不重启等于没改
settings.json 关键开关必须手动写，GUI 点不开深层项
这些配置控制补全质量，但 VSCode 的图形界面设置无法修改全部字段，必须直接编辑 settings.json（全局或工作区）。
-
"editor.suggest.showKeywords": true—— 否则if、for、return不进补全列表 -
"editor.quickSuggestions": {"other": true, "comments": false, "strings": false}—— 字符串里触发补全是反模式，普通代码块必须开 -
"editor.suggest.snippetsPreventQuickSuggestions": false—— 否则写for时不会弹出 for-loop 模板 -
"typescript.preferences.includePackageJsonAutoImports": "auto"—— 否则node_modules里的类型不进提示（TS/JS 专属）
Python 补全卡住？重点查解释器路径和 extraPaths
Python 扩展默认只扫描当前工作区 + site-packages，如果你的模块在 ../shared 或用了 src 目录结构，不显式告诉它，from utils import * 后就看不到函数。
- 确保
python.defaultInterpreterPath指向真实虚拟环境解释器（如"./venv/bin/python"） - 用
python.analysis.extraPaths告诉 Pylance 去哪找源码，例如：["../shared", "src"] - 大型遗留项目中，
python.analysis.typeCheckingMode设为"off"有时反而提升响应速度 - 检查右下角 Python 解释器选择是否正确，点一下就能切
最常被忽略的是：语言服务器是否真在跑、jsconfig.json 或 tsconfig.json 是否存在且路径配置正确、python.analysis.extraPaths 是否覆盖了实际模块位置。这三个点没对齐，其他所有优化都是空中楼阁。
