VSCode代码自动补全需同时满足三条件：语言服务器已加载、文件语言模式正确、项目有可解析的类型/路径上下文；缺一则仅剩关键词拼写建议，无法实现函数签名提示或跨文件跳转。
很多开发者都有过这样的困惑：明明给VSCode装好了插件，为什么代码自动补全（IntelliSense）还是时灵时不灵？其实，这背后有个硬性逻辑：它必须同时满足三个条件才能“聪明”起来——语言服务器已加载、当前文件被识别为正确的语言模式、项目有可解析的类型或路径上下文。三者缺一不可。否则，你看到的很可能只是简单的关键词拼写建议，而无法享受到函数签名提示、参数补全或跨文件跳转这些真正提升效率的功能。
确认语言服务器是否真在运行
调了半天editor.*设置却没反应？问题很可能出在第一步：语言服务压根就没启动起来。这通常不是配置错误，而是前置状态没达标。
- 看右下角状态栏：这里显示的语言必须是
TypeScript、Python、Rust等具体名称。如果显示Plain Text或Unknown，那补全功能基本就“瘫痪”了。 - 手动校正语言模式：按
Ctrl+Shift+P，输入Change Language Mode，然后手动选择正确的语言。像.vue、.jsx、.pyi这类特殊后缀的文件，很容易被错误识别。 - 写一行“错误”代码来测试：比如在TypeScript文件里写
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（纯Ja vaScript项目）或tsconfig.json（TypeScript项目）。文件内容至少需要包含compilerOptions.baseUrl和include字段。 - 配置路径别名：想让
import Button from '@/ui/Button'之后按.能弹出方法列表？必须在compilerOptions.paths里明确配置，例如："@/*": ["src/*"]。 - 明确包含范围：
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—— 这个设置如果为true，当你输入for时，可能会阻止其他快速建议弹出，影响for循环模板的显示。"typescript.preferences.includePackageJsonAutoImports": "auto"—— 对于Ja vaScript/TypeScript项目，这个选项能确保node_modules里的类型定义被纳入提示范围，否则很多第三方库的补全会失效。
Python 补全卡住？重点查解释器路径和 extraPaths
Python扩展（尤其是Pylance）默认的扫描范围有限，通常只包括当前工作区和标准的site-packages目录。如果你的模块放在../shared这类上级目录，或者项目采用了src目录结构，不明确告诉它，那么from utils import *之后，自然就看不到任何函数提示。
- 核对解释器路径：确保
python.defaultInterpreterPath设置指向的是真实的虚拟环境解释器路径，例如"./venv/bin/python"。 - 扩展源码路径：使用
python.analysis.extraPaths配置项，明确告诉Pylance去哪些额外目录查找源码。例如：["../shared", "src"]。 - 权衡类型检查模式：在一些大型的遗留项目中，将
python.analysis.typeCheckingMode设为"off"，有时反而能显著提升补全的响应速度，算是一种实用的取舍。 - 随时切换解释器：养成习惯，经常看一眼VSCode右下角显示的Python解释器是否选对了，点一下就能快速切换。
说到底，最容易被忽略的三个检查点就是：语言服务器是否真的在后台运行、jsconfig.json/tsconfig.json是否存在且路径配置正确、python.analysis.extraPaths是否覆盖了所有实际的模块位置。这三个底层条件如果没对齐，在上面做的任何界面优化或插件配置，都无异于搭建空中楼阁。
