如何配置VSCode实现代码自动补全及智能提示功能？

本文共计1055个文字，预计阅读时间需要5分钟。

VSCode的自动补全功能并非开个开关就全局生效那么简单。它具备多项智能功能，取决于语言模式的识别是否准确、语言服务器是否有加载、项目配置文件是否存在，以及你安装的扩展是否真正实用。

确认 language mode 和 editor.quickSuggestions 是否匹配

右下角状态栏显示的是 Plain Text 还是 JavaScript？如果是前者，editor.quickSuggestions 即使设为 true 也毫无意义——VSCode 根本不认为这是代码文件。常见错误现象：在 .js 文件里写 console. 没提示，点一下右下角手动切到 JavaScript 立刻恢复。

• editor.quickSuggestions 必须按语言上下文启用：比如 {"other": true, "strings": false, "comments": false}，别直接设 true（这在 JSON 或 Markdown 中会意外触发）
• 检查 editor.suggestOnTriggerCharacters 是否为 true，否则输入 .、:、( 不会自动拉出建议框
• 快捷键 Ctrl + Space 可强制唤出建议，用来快速验证补全引擎是否就绪

Python 补全失效，大概率是装错了扩展或没启用 Pylance

搜 “Python” 装了十几个名字带 Python 的扩展？别信图标和下载量。真正起作用的是 ms-python.python（微软官方），且必须确保其内置的 Pylance 语言服务器已激活。

• 打开命令面板（Ctrl + Shift + P），输入 Python: Select Interpreter，选一个有效环境（否则 import numpy 后 numpy. 无方法列表）
• 检查设置中 python.languageServer 值是否为 "Pylance"（默认值，但有人手动改成 "Jedi" 导致参数提示丢失）
• 重启 VSCode 后打开任意 .py 文件，输 os. 看是否列出完整方法；若只有几个基础属性，说明 Pylance 没加载成功

JS/TS 路径和模块补全靠 jsconfig.json 或 tsconfig.json

没有 jsconfig.json，VSCode 就把你的 JS 当记事本处理：import utils from './utils' 之后输 utils. 不出方法，不是插件问题，是项目“没身份”。路径别名（如 @/components）同理，不声明 compilerOptions.baseUrl 和 paths，补全根本找不到目标。

• 最简 jsconfig.json 至少包含：{"compilerOptions": {"module": "nodenext", "target": "es2020", "allowJs": true, "checkJs": true, "moduleResolution": "nodenext"}}
• 使用 @types/xxx 包才能补全第三方库（如 npm install --save-dev @types/node）
• 写 JSDoc 注释（如 /** @param {string} name */）能显著提升参数提示准确度，尤其对纯 JS 项目

路径补全只在特定上下文触发，且默认不模糊匹配

import、require()、HTML 的 src/href、CSS 的 @import 是默认支持路径补全的上下文；但在普通字符串里写 './assets/' 不会弹窗——这不是 bug，是设计限制。

• 要让字符串内也触发，需显式开启："editor.quickSuggestions": {"strings": true}（但慎开，容易干扰写作）
• 路径别名补全依赖 jsconfig.json 中的 baseUrl + paths，改完记得重启 TS 服务（命令面板运行 TypeScript: Restart TS server）
• VSCode 不支持跨工作区路径跳转，也不做模糊匹配（比如输 compo 不会匹配 components），这点和 WebStorm 不同

最容易被忽略的点：补全质量不取决于“开了多少个开关”，而取决于“语言服务有没有拿到足够信息”。缺配置文件、类型定义、正确 interpreter 或 baseUrl 声明，再调 editor.suggest.localityBonus 也没用。先让项目有“身份”，再谈智能。