vscode本身不带python解释器，必须手动指定本地可执行文件路径；90%失败源于路径错误、环境混用或缓存未清理。需先在系统终端确认python --version有输出，再通过python: select interpreter精确选择python.exe或python文件路径（如.venv/scripts/python.exe），并重启vscode窗口以生效。
VSCode 本身不带 Python 解释器，必须手动配对本地可执行文件；90% 的配置失败，根源是路径选错、环境混用或缓存没清——不是 VSCode 不行，是你没告诉它“该用哪个 python.exe”。
python --version 在终端有输出，但 VSCode 找不到解释器
VSCode 不继承 shell 的 PATH，也不自动激活 conda/virtualenv，它只“找”可执行文件，不“猜”环境。你得亲手喂给它完整路径。
- 先在系统终端（非 VSCode 内置终端）运行
python --version或python3 --version，必须有输出；没有？重装 Python 并勾选 “Add Python to PATH”，或手动把类似C:\Users\me\AppData\Local\Programs\Python\Python312\python.exe（Windows）、/opt/homebrew/bin/python3（macOS M1/M2）加进系统环境变量 - macOS 用户别选
/usr/bin/python3（系统自带，受限且过时），Linux 用户确保python3和pip3都可用，缺就补：sudo apt install python3-pip - VSCode 里按
Ctrl+Shift+P输入Python: Select Interpreter，列表为空就点 “Enter interpreter path…”，粘贴上面查到的**完整可执行文件路径**，不是目录
选了 .venv 目录却提示 ModuleNotFoundError 或断点失效
常见错误是把路径设成虚拟环境根目录（如 .venv 或 .venv/Scripts），VSCode 会找不到入口，导致包导入失败、调试器挂起。
- 正确路径必须指向可执行文件：
- Windows venv：
.venv\Scripts\python.exe - macOS/Linux venv：
.venv/bin/python - conda 环境：
~/miniconda3/envs/myproj/bin/python（macOS/Linux）或~/miniconda3/envs/myproj/python.exe（Windows）
- Windows venv：
- 选完后看右下角状态栏是否显示该路径——没变？关掉整个 VSCode 窗口再重开，不是只刷新标签页
- 创建好
.venv后，必须手动用Python: Select Interpreter选中它，VSCode 不会自动识别新生成的虚拟环境
装了 requests 却报 ModuleNotFoundError，pip 和解释器不匹配
你运行 pip install requests，但 pip 指向全局，而 VSCode 当前解释器是 .venv/bin/python，结果包被装到了别处。
- 统一用
python -m pip install：比如在项目根目录终端运行.venv/bin/python -m pip install requests（macOS/Linux）或.venv\Scripts\python.exe -m pip install requests（Windows） - 不要依赖
pip命令本身——它可能属于另一个 Python 安装，只有python -m pip能保证和当前解释器严格一致 - 如果已装错，先进入对应环境的 Scripts/bin 目录，再运行
python -m pip uninstall xxx清理，避免多版本残留干扰
最常被跳过的一步：改完解释器路径后不重启 VSCode，或者用内置终端验证时忘了先激活虚拟环境——VSCode 的语言服务、调试器、linting 全部依赖右下角那个路径，它不动，后面所有功能都只是“假装在工作”。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
