vscode 找不到 python 解释器主因是未扫描自定义环境路径，需手动指定绝对路径：ctrl+shift+p → python: select interpreter → enter interpreter path...，并确保写入 .vscode/settings.json 的 python.defaultinterpreterpath 为真实绝对路径。
VSCode 找不到 Python 解释器，大概率不是插件没装，而是它压根没扫描到你本地已有的环境路径——尤其当你用 conda、pyenv、venv 或手动编译安装时。
为什么 python 命令能用，但 VSCode 就是不识别？
VSCode 的 Python 插件默认只在几个固定位置查找解释器（比如 /usr/bin/python3、C:\Users\...\AppData\Local\Programs\Python\），不会自动遍历 $PATH 或解析 shell 的 alias / function。如果你用 pyenv global 3.11.8 或 conda activate myenv 后终端里 which python 能出结果，但 VSCode 启动时根本没加载你的 shell 配置，自然找不到。
- Windows 用户特别容易卡在 conda 环境：VSCode 默认启动的是“干净” PowerShell/CMD，不执行
conda init注入的初始化脚本 - macOS/Linux 下用
pyenv的用户，如果没在~/.zshrc里正确导出PYENV_ROOT和shims路径，VSCode 图形界面启动时也读不到 - 直接下载的 python.org 安装包，在 macOS 上会装进
/Library/Frameworks/Python.framework/Versions/，这个路径不在 VSCode 默认扫描列表里
手动指定解释器路径最稳，三步搞定
别依赖“自动检测”，直接告诉它你要用哪个 python 可执行文件。
- 打开命令面板：
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（Mac） - 输入并选择：
Python: Select Interpreter - 在弹出的列表顶部点
Enter interpreter path...→ 浏览或粘贴路径，例如：/opt/homebrew/bin/python3（Homebrew）、~/miniconda3/envs/myproject/bin/python（conda）、~/.pyenv/versions/3.12.1/bin/python（pyenv）
确认后，VSCode 会在当前工作区生成 .vscode/settings.json，写入类似：
"python.defaultInterpreterPath": "~/miniconda3/envs/myproject/bin/python"注意：这里填的是绝对路径，不要用
~，建议先 realpath 或 which python 拿到完整路径再粘贴。
python.defaultInterpreterPath 和工作区设置的优先级关系
VSCode 的 Python 解释器选择遵循明确覆盖顺序：工作区设置 > 用户设置 > 自动发现。也就是说，一旦你在项目根目录下的 .vscode/settings.json 里写了 python.defaultInterpreterPath，它就永远优先生效，哪怕你换机器、重装插件也不影响。
- 多人协作时，把这个路径设成相对项目友好的（比如指向
./venv/bin/python），比写死绝对路径更可靠 - 如果用了 Poetry，可设为
./.venv/bin/python（Linux/macOS）或./.venv/Scripts/python.exe（Windows） - 避免在用户级设置（
settings.json全局）里硬编码某个 conda 环境路径，否则新开其他项目会继承错环境
终端集成不等于解释器集成
即使你在 VSCode 设置里打开了 python.terminal.executeInFileDir，或者配置了 terminal.integrated.defaultProfile 让终端自动激活 conda，这跟编辑器底层语法分析、调试、linting 所用的 Python 解释器是两回事。前者只影响集成终端，后者由 python.defaultInterpreterPath 单独控制。
- 常见症状：终端里
pip list显示有numpy，但编辑器里import numpy还是标红、跳转失败、提示 “ModuleNotFoundError” - 验证方式：按
Ctrl+Shift+P→Python: Show Output，看输出面板里 “Python Interpreter” 那行实际加载的是哪个路径 - 调试时跑不起来？检查
launch.json里的python字段是否显式覆盖了解释器路径，否则它仍会 fallback 到python.defaultInterpreterPath
真正麻烦的从来不是找不到解释器，而是你以为它找到了，其实用的是系统自带的旧版本，或者某个被遗忘的全局 site-packages。每次新建项目，花十秒确认一下 Python: Select Interpreter 弹窗里高亮的是不是你预期的那个路径，比后面查半天 import 错误省心多了。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
