如何设置VSCode实现代码自动补全功能？

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

VSCode的代码自动补全功能并非打开关闭就全局好用那么简单，其实际上的高效前提是：

为什么 os. 没提示？先确认 Python 扩展装对了

90% 的 Python 补全失效，源于装了错误的扩展。搜“Python”后随手点安装，很可能装的是 tht13.python 或其他非官方包——它们不带 Pylance，也不支持现代类型推导。

• 必须卸载所有非 ms-python.python 的 Python 相关扩展（尤其是旧版 python）
• 确保安装的是发布者为 Microsoft 的 ms-python.python
• 检查设置中 "python.languageServer" 值为 "Pylance"（默认即如此，但手动确认更稳）
• 重启 VSCode 后，在 .py 文件里输入 import os，再敲 os. —— 如果弹出完整方法列表，说明 LSP 已就位

jsconfig.json 是 JS/TS 补全的硬性门槛

没有 jsconfig.json（JS 项目）或 tsconfig.json（TS 项目），VSCode 就不会启动 TypeScript 语言服务，import utils from './utils' 后输 utils. 必然空白——这不是插件问题，是项目“没身份”。

• 在项目根目录新建 jsconfig.json，内容至少包含：

  { "compilerOptions": { "module": "commonjs", "target": "es2020", "allowSyntheticDefaultImports": true, "esModuleInterop": true }, "include": ["**/*.js"] }

• 若项目用 ESM（type: "module"），则需改 "module": "nodenext" 并加 "moduleResolution": "nodenext"
• 用了路径别名（如 @/components）？必须在 compilerOptions.baseUrl 和 paths 中显式声明，否则补全找不到目标
• 删掉这个文件，补全立刻退化——这就是它起作用的最直接证据

editor.quickSuggestions 被关了，补全根本不会弹

VSCode 默认在某些语言（如 JSON、Markdown）里把自动提示关掉了。你敲 console. 没反应，大概率就是这个开关被设成了 false。

• 打开 Settings (JSON)（Ctrl+Shift+P → “Preferences: Open Settings (JSON)”）
• 确认有这段配置：

  "editor.quickSuggestions": { "other": true, "comments": false, "strings": true }

• strings: true 很关键——否则 require('./') 或 import() 里的路径补全也不会触发
• 别只改 UI 界面里的开关，它可能只作用于当前工作区；JSON 配置才是全局底线

editor.autoClosingBrackets 不等于补全，但常被误关

括号、引号、HTML 标签的自动闭合和智能补全（IntelliSense）是两套机制。很多人以为“补全没反应”是 IntelliSense 问题，其实只是基础闭合被关了。

• editor.autoClosingBrackets 只接受三个值：always、languageDefined、never；写成 false 是非法值，VSCode 会静默忽略
• 推荐统一设为 "always"，并在 JSON 设置中按语言 ID 单独控制，例如：

  "[javascript]": { "editor.autoClosingBrackets": "always" }

• HTML 标签闭合还依赖语言模式：右下角显示 Plain Text 时，任何语言级行为都无效；务必先保存为 .html 或手动切换为 HTML

最容易被忽略的是语言模式识别和配置文件的存在性——它们不像插件那样“看得见”，却决定着补全引擎是否启动。一旦 os. 或 utils. 不出建议，优先查这两处，比重装插件快得多。