vscode不会自动继承终端python环境，需手动指定解释器路径并重启窗口；推荐用python -m venv创建虚拟环境，确保路径正确、四类运行环境（编辑器/终端/调试/jupyter）各自配置，conda环境需手动指定condapath。
VSCode 不会自动继承终端的 Python 环境，必须手动指定解释器路径；选错路径或没重启，90% 的 ModuleNotFoundError 和补全失效都由此而来。
怎么让 VSCode 找到你本地的 Python 解释器
它不扫描 PATH，也不读 shell 激活状态。即使你在终端里能跑 python --version，VSCode 也可能完全看不到那个解释器。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入并选择Python: Select Interpreter - 列表里优先选带完整路径的项，比如
/opt/homebrew/bin/python3（macOS）、C:\Users\Me\AppData\Local\Programs\Python\Python312\python.exe（Windows），别选只写python3的模糊条目 - 如果列表为空，点
Enter interpreter path...，然后粘贴绝对路径——可用终端执行which python3（macOS/Linux）或where python（Windows）查 - 选完后立刻看右下角状态栏：没变？不是设置失败，是得关闭并重新打开整个 VSCode 窗口（不是标签页）
为什么 python -m venv .venv 创建的环境最稳
VSCode 的 Python 扩展对标准库 venv 模块生成的结构识别率最高。用 virtualenv 或 pipenv 时，路径命名和激活脚本差异容易导致解释器路径解析失败，尤其在 Windows 上报 ModuleNotFoundError: No module named 'venv'。
- 在项目根目录终端运行：
python -m venv .venv（Python ≥ 3.3） - 确认生成成功：
.venv/Scripts/python.exe（Windows）或.venv/bin/python（macOS/Linux）存在 - 立刻执行
Python: Select Interpreter，手动导航到上面那个python文件——不要等装完包再选，否则可能误选系统 Python - 路径必须写成相对形式，如
"python.defaultInterpreterPath": "./.venv/bin/python"，否则换机器打开就失效
选对了解释器，import 还报错？检查这三处独立配置
VSCode 的编辑器、终端、调试器、Jupyter kernel 是四套独立加载机制。解释器路径设对了，只是第一步。
- 左下角状态栏显示的路径，只影响编辑器补全和 linting；点它可重新确认
- 集成终端默认不激活虚拟环境——除非你在设置里开了
python.terminal.activateEnvironment，或者右上角终端下拉菜单里手动选了带(venv)标记的选项 - 调试时断点不生效？打开
.vscode/launch.json，确认"python.defaultInterpreterPath"指向的是.venv内的python，且没被用户级设置覆盖；如果项目有src/目录，还要加"cwd": "${workspaceFolder}/src" - Jupyter Notebook 右上角 kernel 下拉菜单，和编辑器解释器无关，要单独点选匹配的 kernel
conda 环境列不出来？先确认 conda 是否被 VSCode “看见”
VSCode 默认只扫描 PATH 里的 conda 命令，再从 conda info --json 读取 envs 路径。如果用的是 Miniforge、micromamba 或自定义安装路径，它大概率找不到。
- 在命令面板运行
Python: Show Output，切换到Python面板，看有没有conda info --json执行失败的日志 - 手动告诉扩展 conda 位置：在
settings.json里加一行"python.condaPath": "/path/to/conda"（Linux/macOS 填conda可执行文件本身，Windows 填conda.bat） - 保存后必须执行
Developer: Reload Window，再试Python: Select Interpreter - 别选
base环境——它易因升级损坏，也不利于隔离依赖；用conda env list确认你要的环境名和路径
最常被忽略的一点：VSCode 的 Python 扩展会缓存解释器信息，切换环境后不重启窗口，Pylance 仍用旧环境的类型索引，补全和跳转会错乱——这不是 bug，是设计使然。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
