VSCode找不到Python解释器需先确认安装官方Python扩展，通过命令面板执行“Python: Select Interpreter”，若列表为空则手动输入绝对路径；终端、调试器、Jupyter内核需分别重启或切换kernel以生效。
找不到 Python 解释器选项
VSCode 没弹出解释器选择面板，通常是因为当前工作区没识别到任何 Python 环境，或者 python.pythonPath（旧版配置）已被弃用，新版本只认 python.defaultInterpreterPath 或交互式选择逻辑。
- 先确认已安装 Python 扩展（Microsoft 官方那个，ID 是
ms-python.python），禁用/重装一次常能修复状态错乱 - 打开命令面板（
Ctrl+Shift+P/Cmd+Shift+P），搜Python: Select Interpreter—— 不要依赖右下角状态栏点击，有时它不响应 - 如果列表为空，手动添加：点击
Enter interpreter path...，然后填入你本地 Python 可执行文件的绝对路径，比如/usr/local/bin/python3.9（macOS）、C:\Users\Me\AppData\Local\Programs\Python\Python311\python.exe（Windows）
选了 3.11 却还是跑在 3.9 上
解释器切换成功 ≠ 当前终端或调试会话自动生效。VSCode 的终端、调试器、Jupyter 内核是三套独立上下文，各自缓存解释器路径。
- 新开一个集成终端（
Ctrl+Shift+`），老终端不会刷新 Python 版本；关掉再开，或运行source ~/.zshrc（macOS/Linux）让它重新读环境变量 - 调试时必须重启 Debug 会话，改了解释器后点
Restart Debugging，否则仍用旧进程 - Jupyter Notebook 里右上角 kernel 名字可能滞后，点它 →
Change kernel→ 选对的 Python 环境，别信默认显示
虚拟环境路径识别失败
VSCode 对 venv、poetry、conda 环境的支持依赖路径结构和激活状态，不是所有“带 python.exe 的文件夹”都能被自动发现。
-
venv必须在项目根目录下，且子目录含pyvenv.cfg和bin/python（macOS/Linux）或Scripts\python.exe（Windows）；放在envs/这类嵌套目录里，需手动指定路径 -
conda环境要先运行conda init并重启 VSCode，否则它看不到 conda 环境列表 -
poetry用户注意：poetry shell启动的终端不会同步给 VSCode，得用poetry env info --path拿到路径，再在 VSCode 里手动选
多工作区下解释器互相干扰
VSCode 支持工作区级（.vscode/settings.json）和用户级解释器设置，优先级容易搞混，导致 A 项目切了 3.10，B 项目莫名也跟着变。
立即学习“Python免费学习笔记（深入）”；
- 检查
.vscode/settings.json里有没有硬编码的"python.defaultInterpreterPath"，有就删掉，让 VSCode 自动探测 - 用户级设置（Settings UI → Python → Default Interpreter Path）会影响所有未配置的工作区，慎填；日常建议只在项目级配置
- 不同工作区用不同 Python 版本时，务必确认每个工作区的
settings.json文件存在且内容独立，别用软链接共用一份
