VSCode代码自动补全生效需同时满足三个硬性条件：语言服务器已加载、文件被识别为正确语言模式、项目具备可解析的类型/路径上下文；缺一不可。
VSCode 的代码自动补全不是“开个开关就生效”的功能，它是否弹出 os. 后的完整方法列表、能否补全 import numpy 后的 np.、甚至能不能识别 @/utils 别名并提示内部函数——全取决于三个硬性条件是否同时满足：语言服务器已加载、文件被识别为正确语言模式、项目有可解析的类型/路径上下文。
确认右下角语言模式和 editor.quickSuggestions 是否匹配
常见错误现象：在 .py 文件里输 import os; os. 没反应，点一下右下角状态栏手动切到 Python 立刻恢复。这是因为 VSCode 默认可能把文件当成 Plain Text 或 Unknown，此时所有 editor.* 补全设置都无效。
-
editor.quickSuggestions必须按语言上下文启用，例如{"other": true, "strings": false, "comments": false}；别直接设true（在 JSON 或 Markdown 中会意外触发） -
editor.suggestOnTriggerCharacters必须为true，否则输入.、:、(不会自动拉出建议框 - 快捷键
Ctrl + Space可强制唤出建议，用来快速验证补全引擎是否就绪
Python 补全失效？大概率是 Pylance 没真正加载
装了十几个名字带 “Python” 的扩展？别信图标和下载量。真正起作用的是 ms-python.python（微软官方），且必须确保其内置的 Pylance 语言服务器已激活。
- 打开命令面板（
Ctrl + Shift + P），输入Python: Select Interpreter，选一个有效环境（否则import numpy后numpy.无方法列表） - 检查设置中
python.languageServer值是否为"Pylance"（默认值，但有人手动改成"Jedi"导致参数提示丢失） - 重启 VSCode 后打开任意
.py文件，输os.看是否列出完整方法；若只有几个基础属性（如__name__），说明Pylance没加载成功 - 卸载所有非
ms-python.python的 Python 相关扩展（特别是旧版python）
JS/TS 补全卡在 import utils from './utils' 后没提示？缺 jsconfig.json
没有 jsconfig.json 或 tsconfig.json，VSCode 就把你的 JS 当记事本处理：路径别名（如 @/components）、模块推导、类型提示全部失效。这不是插件问题，是项目“没身份”。
- 在项目根目录新建
jsconfig.json（JS 项目）或tsconfig.json（TS 项目） - 最简配置至少包含：
{"compilerOptions": {"module": "nodenext", "target": "es2020", "allowJs": true, "checkJs": true, "moduleResolution": "nodenext"}} - 若用路径别名（如
@/），必须声明compilerOptions.baseUrl和compilerOptions.paths，否则import Button from '@/ui/Button'后按.不出方法 - 改完立刻执行
Ctrl + Shift + P→TypeScript: Restart TS server，不重启等于没改
settings.json 里必须手写的几个关键项
图形界面设置（GUI）点不开深层项，这些影响补全质量的配置必须直接编辑 settings.json（全局或工作区）：
-
"python.analysis.autoImportCompletions": true—— 允许补全时自动插入import语句 -
"python.analysis.completeFunctionParens": true—— 输入函数名后自动补全括号和参数占位符 -
"editor.tabCompletion": "on"—— 用Tab键插入当前高亮建议（比Enter更安全，避免误触发） -
"editor.acceptSuggestionOnEnter": "off"—— 关闭回车接受建议，防止写if时误按Enter插入if语句而非换行
最容易被忽略的点是：补全不是“一次性配置”，而是每新建一个项目、每切换一次解释器、每改一次 jsconfig.json，都要重新验证语言服务器是否接管。状态栏显示语言名 ≠ 语言服务器真在运行，看输出面板里的日志才是唯一可靠依据。
