根本原因是VSCode GUI启动时未加载Shell环境变量（如~/.zshrc中的PATH），导致无法识别pyenv、conda等管理的Python；需从终端运行code .启动，或配置launchctl/setenv，同时确认Python扩展已启用且工作区settings.json中路径正确。
VSCode 显示“找不到 Python 解释器”但终端能用
根本原因不是 Python 没装，而是 VSCode 启动时没读到你的 Shell 环境变量（比如 ~/.zshrc 或 ~/.bash_profile 里写的 PATH）。GUI 方式启动的 VSCode（比如从 Dock 点击、Spotlight 搜索打开）默认不加载 Shell 配置，所以它看不见你通过 pyenv、conda 或 brew 装的 Python。
验证方法：在 VSCode 内置终端运行 echo $PATH，再对比你在 iTerm / Terminal 里执行同样命令的结果。如果前者不含 ~/.pyenv/shims、/opt/homebrew/bin 或 ~/miniconda3/bin，就坐实了这个问题。
- 临时解决：从终端启动 VSCode —— 运行
code .（确保已安装code命令） - 长期解决：macOS 上可配置
launchctl setenv PATH；Windows 上检查系统环境变量是否包含 Python 安装路径（如C:\Python311\和C:\Python311\Scripts\） - 别依赖“自动发现”：VSCode 只查几个固定路径（如
/usr/bin/python3、C:\Users\XXX\AppData\Local\Programs\Python\），pyenv的python3.11或 conda 的envs/myproj/bin/python必须手动指定
选了解释器后仍报 ModuleNotFoundError
这几乎 100% 是解释器和 pip 不匹配：你在终端里运行 pip install requests，实际调用的是 /usr/local/bin/pip（对应系统 Python），但 VSCode 当前选中的是 ~/venv/bin/python —— 两者 site-packages 完全隔离。
关键动作不是重装包，是确认并统一执行环境：
立即学习“Python免费学习笔记（深入）”；
- 在 VSCode 内置终端中运行：
python -c "import sys; print(sys.executable)"记下路径 - 用同一路径的 Python 调 pip：
/full/path/to/python -m pip install requests - 检查安装位置：
/full/path/to/python -m pip show requests | grep Location，输出的Location应该是sys.executable所在目录的上两级（如/path/to/venv/lib/python3.11/site-packages） - 如果右下角状态栏显示的解释器路径和上面
sys.executable不一致，说明你选错了——按Ctrl+Shift+P→Python: Select Interpreter重新选
.vscode/settings.json 里 python.defaultInterpreterPath 写死了错误路径
这个配置项优先级最高，一旦写错，VSCode 就会无视你手动选的解释器，甚至忽略全局设置。常见于 Git 同步项目、复制工作区或误操作后残留。
典型症状：你明明在命令面板里选了 ~/myproject/venv/bin/python，但右下角还是显示 /usr/bin/python3，且 Python: Select Interpreter 列表里也看不到刚选的那个。
- 直接删掉项目根目录下的
.vscode/settings.json文件（它只影响当前工作区） - 或者打开该文件，删掉整行
"python.defaultInterpreterPath": "/wrong/path/python" - 不要在用户设置里全局写死这个值（
Ctrl+,→ 搜python default interpreter→ 清空输入框） - 改完不用重启，VSCode 几秒内自动重载，状态栏会刷新
conda / pyenv / poetry 环境选对了，Pylance 还标红 import
Pylance 报错不等于代码真错，它只是没找到模块定义。可能原因不是包没装，而是 Pylance 没扫描到正确的 site-packages，或导入名和包名不一致（比如 python-dotenv 的导入名是 dotenv）。
先排除路径问题：
- 确认右下角解释器路径和
python -c "import sys; print(sys.path[0])"输出的首个路径一致（通常是.../lib/python3.x/site-packages的父目录） - 检查
python.analysis.extraPaths设置是否被误填 —— 留空最安全，填了反而干扰索引 - 运行
python -c "import pkgutil; print([name for _, name, _ in pkgutil.iter_modules() if 'dotenv' in name])"查真实导入名 - 如果刚装完包就标红，等 10–20 秒让 Pylance 重建缓存；还不行就按
Ctrl+Shift+P→Developer: Reload Window
最易被忽略的一点：VSCode 的 Python 扩展必须启用，且不能损坏。如果左下角连“Python”字样都不显示，先检查扩展列表里 ms-python.python 是否已启用 —— 没它，整个解释器选择逻辑都不会触发。
