VS Code中Python补全失效首要确认解释器是否选对：按Ctrl+Shift+P输入“Python: Select Interpreter”，查看列表中是否显示有效路径（如./venv/bin/python）；若为空或仅显示模糊项，说明VS Code未识别解释器，需检查Python是否安装并加入PATH、虚拟环境是否创建并激活、或从正确终端启动VS Code。
VS Code 里 Python 补全失效，大概率不是插件没装，而是解释器根本没选对或路径没识别到。
怎么确认当前选中的 Python 解释器？
快捷键 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入并选择 Python: Select Interpreter。命令面板会列出已检测到的解释器，包括虚拟环境路径（如 ./venv/bin/python 或 .\env\Scripts\python.exe）、系统 Python 和 Conda 环境。
注意：如果列表为空或只有 Python 3 这种模糊项，说明 VS Code 没找到有效解释器——可能因为没安装 Python、没把 python 加入 PATH，或虚拟环境未激活且路径未被自动扫描。
- 检查终端里运行
which python（macOS/Linux）或where python（Windows）是否返回有效路径 - 如果用
venv，确保先执行过python -m venv venv，再重新打开文件夹（VS Code 需要重载工作区才能刷新解释器列表） - Conda 用户建议在终端先运行
conda activate myenv，再从该终端启动 VS Code：code .，否则插件常找不到环境
为什么装了 Pylance 却没有类型提示和跳转？
Pylance 是默认启用的 Python 语言服务器，但它严重依赖解释器中已安装的包信息。如果 pip install 是在别的环境里做的，而 VS Code 当前选的是另一个解释器，补全就会“看不见”那些包。
立即学习“Python免费学习笔记（深入）”；
仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成，提供 184 种工具和 200 多条命令，用于安全分析和代码质量...
典型表现：import numpy 不报错，但 np. 按下点号后无补全、Ctrl+Click 跳不到定义。
- 确认当前解释器路径下运行
pip list是否包含你要用的包（比如numpy、requests） - 不要在全局 Python 里 pip 安装，然后切到 venv 里指望补全——两个环境隔离，Pylance 只读当前解释器的 site-packages
- 若刚
pip install完，等几秒或手动触发Developer: Restart Language Server（在命令面板里搜）
补全卡顿或响应慢，是不是要关掉 Pylance？
不推荐直接禁用 Pylance。更常见原因是工作区里有大量未忽略的第三方代码或构建产物，导致语言服务器反复索引。
检查项目根目录是否有 .vscode/settings.json，添加以下配置可显著提速：
{
"python.analysis.extraPaths": ["src"],
"python.analysis.exclude": ["**/node_modules/**", "**/__pycache__/**", "**/venv/**", "**/.mypy_cache/**"]
}
其中 exclude 是关键：VS Code 默认会递归扫描整个文件夹，包括 venv 或 dist 下几万个小文件，Pylance 一卡就是十几秒。
- 避免把 Python 项目放在超大父目录（比如整个 GitHub 克隆仓库）下打开，尽量精准打开
./myproject - 如果用 Poetry，确保
poetry install后，VS Code 选的是 Poetry 创建的虚拟环境路径（通常形如~/.cache/pypoetry/virtualenvs/myproject-xxx-py3.x）
最常被忽略的一点：VS Code 的 Python 扩展不会自动监听解释器目录变更。换环境、重装 Python、迁移项目后，务必手动触发一次 Python: Select Interpreter，而不是依赖“上次选的还在”。
