VSCode配置Python失败主因是解释器未正确安装或未选中。需确保Python已装入PATH、在VSCode中显式选择绝对路径解释器、虚拟环境须手动绑定、插件安装后必须重启VSCode并重启语言服务器。
VSCode 本身不带 Python 运行时，配置失败的核心原因几乎全是解释器没选对、没装对，或 VSCode 没认出它。不是插件装得不够多，而是路径没指定准。
Python 解释器没装或没加进 PATH
VSCode 的 Python 插件不会帮你装 Python，它只负责“找”。如果终端里 python --version 报错，VSCode 肯定也找不到。
- Windows：重装 Python 时务必勾选
Add Python to PATH；漏选了就重装，别折腾手动加环境变量（容易错位、权限不足） - macOS（M1/M2）：终端运行
which python3，常见路径是/opt/homebrew/bin/python3；别用/usr/bin/python3（系统自带，不支持 pip install） - Linux：确认
python3和pip3都可用，缺就补：sudo apt install python3-pip
VSCode 没选中正确的 Python 解释器
即使 Python 装好了，VSCode 默认也不会自动绑定——它必须显式指定绝对路径，否则运行、调试、补全、import 全部可能指向不同环境。
- 打开项目文件夹（不是单个 .py 文件），按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS） - 输入
Python: Select Interpreter，从列表里选带完整路径的项，例如：C:\Users\Name\AppData\Local\Programs\Python\Python312\python.exe或./venv/bin/python - 若列表为空，点
Enter interpreter path…，粘贴终端执行where python（Win）或which python3（macOS/Linux）得到的路径 - 选完后看右下角状态栏是否显示该路径；没更新？关掉整个 VSCode 窗口再重开（仅关标签页无效）
虚拟环境没激活或没绑定到 VSCode
用 python -m venv .venv 创建了虚拟环境，但 VSCode 仍报 ModuleNotFoundError，说明你装包的环境和 VSCode 当前用的解释器不是同一个。
立即学习“Python免费学习笔记（深入）”；
- 创建后，必须在 VSCode 中再次执行
Python: Select Interpreter，并手动选中.venv\Scripts\python.exe（Win）或.venv/bin/python（macOS/Linux） - 装包统一用
python -m pip install xxx，避免pip install调用错 pip 版本 - 不要在终端里手动
activate后再开 VSCode —— VSCode 不继承 shell 激活状态，它只认你选的那个解释器路径
插件装了但功能不生效
装完 Python 插件后没语法提示、无法调试、F5 报错，大概率是语言服务器没起来，或者缓存卡住了。
- 确保已安装 Microsoft 官方插件：
ms-python.python（不是其他同名第三方） - 装完必须重启 VSCode（不是重载窗口），否则语言服务不加载
- 切换解释器后，按
Ctrl+Shift+P运行Python: Restart Language Server，强制刷新上下文 - 如果右下角状态栏一直显示“Starting Pylance…”或卡住，删掉项目根目录下的
.vscode文件夹再重试
最常被忽略的是：VSCode 的 Python 扩展会缓存解释器信息，哪怕你改了 settings.json 或删了 .venv，它也可能还在用旧路径。每次换环境，都要重新 Select Interpreter + Restart Language Server，不能靠“应该自动同步”来赌。
