VSCode需安装Microsoft官方Python扩展并正确配置解释器和Pylance语言服务器才能实现Python智能补全；否则import后无成员提示、str.无方法、类型提示失效。
VSCode 本身不自带 Python 智能补全能力，必须安装 Python 扩展并正确配置解释器和语言服务器；否则 import 后看不到模块成员、str. 点不出方法、类型提示也不生效。
装对扩展：只留 Microsoft 官方 Python 扩展
在扩展市场搜 “Python”，认准发布者是 Microsoft、ID 是 ms-python.python 的那个。卸载所有其他名字带 “Python” 但发布者不是 Microsoft 的扩展（比如 “Python Extension Pack”、“Pylance” 单独安装包等），因为 Pylance 已被集成进最新版官方扩展中，重复安装反而会冲突。
安装后重启 VSCode，确保状态栏右下角出现 Python 版本号（如 Python 3.11.8），点它可切换解释器。
选准解释器：必须指向你实际用的 python 可执行文件
智能补全依赖解释器路径来索引标准库和已安装包。如果选错，requests.get() 会标黄、numpy.array 提示 “Unknown symbol”。
立即学习“Python免费学习笔记（深入）”；
操作步骤：
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Python: Select Interpreter - 从列表选你项目实际用的环境：虚拟环境的
venv/bin/python（macOS/Linux）或venv\Scripts\python.exe（Windows），或 conda 环境的anaconda3/envs/myenv/python.exe - 确认后 VSCode 会在工作区根目录生成
.vscode/settings.json，含类似字段："python.defaultInterpreterPath": "./venv/bin/python"
启用 Pylance 并调优：补全质量取决于它
Pylance 是微软开发的语言服务器，负责类型推断、跳转定义、补全建议。默认已启用，但以下配置能显著改善体验：
- 在
settings.json中加："python.languageServer": "Pylance"
- 若补全太慢或漏包，加：
"python.analysis.extraPaths": ["./src", "./lib"]
（把自定义模块路径告诉它） - 禁用 Jedi（旧引擎）：
"python.jediEnabled": false
，避免和 Pylance 抢资源 - 开启类型检查提示（非阻断）：
"python.analysis.typeCheckingMode": "basic"
改完保存，VSCode 会自动重启语言服务器。此时 from pathlib import Path; p = Path(); p. 应立刻列出 resolve()、exists() 等方法。
验证补全是否真生效：别只看 print()
容易忽略的是：补全对第三方包（如 pandas、fastapi）依赖 pip install 是否在当前解释器环境下执行。常见坑：
- 你在系统 Python 里装了
requests，但 VSCode 选的是 venv 解释器 → 补全不出现 -
pip install -e .没运行，本地包没进sys.path→ 自己写的模块补全不了 - 使用 Poetry 或 Pipenv，未通过
poetry shell或pipenv shell激活环境就直接开 VSCode → 解释器路径不对
最稳的验证方式：新建 test.py，写 import numpy; np = numpy; np.，看弹出菜单是否含 array、zeros —— 这一步过了，说明解释器、Pylance、包安装三者全对齐。
