VS Code 无法找到 Python 解释器是因为不自动继承终端环境变量，需手动通过“Python: Select Interpreter”选择完整路径的解释器，并确保调试、终端等组件统一使用该路径。
找不到 Python 解释器，python 命令能运行但 VS Code 里标红
VS Code 不会自动继承系统终端的环境（比如 shell 的 PATH 或 conda 激活状态），即使你在终端里能跑 python --version，它也可能完全看不到那个解释器。
实操建议：
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入并选择Python: Select Interpreter - 优先从列表里选带完整路径的项，比如
/usr/bin/python3、~/miniconda3/envs/myenv/bin/python；避免只写python或python3的模糊条目 - 如果列表为空，点“Enter path”，手动粘贴解释器绝对路径（可用
which python或conda env list查） - 选完后看右下角状态栏是否显示对应路径——没变？重启 VS Code 窗口（不是标签页）再试
ModuleNotFoundError 在 VS Code 终端里报，但系统终端不报
这是典型环境错位：你选的解释器和当前集成终端用的不是同一个。VS Code 的集成终端默认启动的是 shell 默认环境，不是你选的 Python 解释器所在环境。
实操建议：
- 在 VS Code 里打开新终端时，先确认右上角终端下拉菜单是否选中了「Python」环境（它会自动激活对应虚拟环境）
- 如果没这个选项，说明解释器未被正确识别——回到上一步重新选一次，并确保路径指向虚拟环境内的
python（如venv/bin/python） - 不想依赖自动激活？在设置里搜
python.terminal.executeInFileDir，关掉它；再把python.defaultInterpreterPath设为绝对路径，这样终端启动时会尝试复用该环境
用 conda 环境，但 Python: Select Interpreter 列不出任何 conda 环境
VS Code 的 Python 扩展默认只扫描 conda 可执行文件路径下的 envs 目录，如果 conda 安装位置特殊（比如 Miniforge、自定义安装路径、或 Windows 上用的 micromamba），它就找不到。
实操建议：
- 先确认 conda 是否可被 VS Code 调用：在命令面板运行
Python: Show Output，切换到 “Python” 面板，看有没有类似conda info --json执行失败的日志 - 手动告诉扩展 conda 位置：在
settings.json里加一行"python.condaPath": "/path/to/conda"（Linux/macOS 是conda文件本身，Windows 是conda.bat） - 改完保存，然后强制重载窗口（
Ctrl+Shift+P→Developer: Reload Window），再试Python: Select Interpreter
配置好了，但调试（Debug）还是用错解释器或断点不生效
VS Code 的调试器（launch.json）默认不读取你通过 UI 选的解释器，它要么用全局默认，要么用配置里硬写的 python —— 这是调试阶段最常被忽略的脱节点。
实操建议：
- 项目根目录下建
.vscode/launch.json，确保里面有"python"类型配置，且"python"字段明确指向解释器路径，例如："python": "${workspaceFolder}/venv/bin/python" - 更省事的做法：删掉
launch.json，直接按F5启动调试，VS Code 会弹出模板推荐，选“Python File”，它会自动生成带正确python路径的配置 - 断点无效？检查左下角调试面板顶部是否显示“Python”而非“Node.js”之类；再确认文件是否以
.py结尾、没被排除在launch.json的"justMyCode"外
选解释器只是第一步，真正卡住人的永远是“哪个组件认哪个路径”——编辑器 UI、集成终端、调试器、甚至代码补全引擎，它们各自查路径的方式可能完全不同。多看 Python: Show Output 里的日志，比反复重装扩展管用得多。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
