VSCode如何开启代码自动补全？Pylance深度优化【实战】-VSCode-PHP中文网

vscode代码自动补全生效需同时满足三个硬性条件：语言服务器已加载、文件被识别为正确语言模式、项目具备可解析的类型/路径上下文；缺一不可。

vscode如何开启代码自动补全？pylance深度优化【实战】

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 语言服务器已激活。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

打开命令面板（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 语句而非换行