VSCode Python自动导入需启用Pylance并设python.analysis.autoImportCompletions: true、editor.quickSuggestions.other: true，且语言模式为Python；Ctrl+.触发Quick Fix或Ctrl+Space选带灯泡项才能插入import，索引完成前（右下角“分析中…”消失后）无效。
VSCode 的 Python 自动导入不是开箱即用的功能，必须启用 Pylance 并正确配置 python.analysis.autoImportCompletions，否则 Ctrl+. 什么都不会弹出来。
确认语言服务器是 Pylance 而非默认 Python
很多人装了“Python”扩展就以为万事大吉，但 VSCode 默认可能仍在用旧版语言服务器（如 Jedi），它不支持自动导入补全。
- 打开设置（
Ctrl+,），搜索python.languageServer，确保值为"Pylance"（字符串，带双引号） - 右下角状态栏点击语言模式，确认显示
Python（不是Plain Text或Python (Jedi)） - 如果显示
Python (Jedi)，点击切换 → 选择Python (Pylance) - 重启 VSCode 后打开一个
.py文件，等待右下角出现“分析中…”，结束后再试
必须开启的三个关键配置项
仅勾选 UI 界面里的“Auto Import Completions”不够，底层 JSON 设置必须显式生效：
-
python.analysis.autoImportCompletions：设为true（布尔值，不是字符串"true"） -
editor.quickSuggestions→"other"必须为true（否则输datetime.不触发建议） -
editor.suggest.showMethods和editor.suggest.showFunctions建议保持启用，否则函数名不进补全列表
推荐直接在 settings.json 中写死：
立即学习“Python免费学习笔记（深入）”；
{
"python.languageServer": "Pylance",
"python.analysis.autoImportCompletions": true,
"editor.quickSuggestions": {
"other": true,
"strings": false,
"comments": false
}
}
触发自动导入的两种可靠方式
别等输入完回车——那大概率只插入名字，不加 import。真正稳定的是以下操作：
- 输入未导入的符号（如
np.array、Path.joinpath、calculate_square），光标停在末尾，按Ctrl+.（Windows/Linux）或Cmd+.（Mac），弹出 Quick Fix 菜单，选“Import … from …” - 输入前几个字母（如
datetim），按Ctrl+Space唤起 IntelliSense，从带小灯泡图标的选项里选，会自动插入from datetime import datetime - 注意：如果模块在本地（如
utils.py），需确保该文件在当前工作区根目录下，且路径可被 Pylance 索引到（不能放在未打开的子文件夹里）
常见失效场景与排查顺序
当 Ctrl+. 没反应、补全列表里没有 import 项时，按此顺序检查：
- 右下角语言模式是不是
Python？不是就点它手动切 - 项目根目录有没有
pyproject.toml或setup.py？没有的话 Pylance 可能无法识别包结构，本地模块导入失败 - 终端执行
python -c "import numpy; print(numpy.__version__)"，确认包已安装且可被当前解释器访问 - 打开命令面板（
Ctrl+Shift+P），运行Python: Restart Language Server，强制刷新符号索引 - 禁用所有非必要插件（尤其旧版 “Auto Import”、“Python Docstring Generator”），它们会劫持补全逻辑
最常被忽略的一点：Pylance 的自动导入依赖符号索引完成，而索引是在文件保存后或编辑器空闲时异步构建的。刚新建的 .py 文件，哪怕只写了一行，也得等右下角“分析中…”消失才能用。 impatient 等不及，就先保存一下文件。
