VSCode 需手动指定 venv 或 conda 解释器路径，因其不自动递归扫描；正确路径为 venv/Scripts/python.exe（Win）或 venv/bin/python（macOS/Linux），conda 环境需确保 conda 在 PATH 中且通过 conda env list 确认路径。
VSCode 不能自动识别你本地的 venv 或 conda 环境，必须手动指定解释器路径；否则它默认用系统 Python，导致包导入失败、调试报错、pip install 装到错地方。
怎么让 VSCode 找到你的 venv 目录
VSCode 不会递归扫描项目文件夹找 venv，它只检查几个固定位置（比如 .venv、venv、env），而且只在当前打开的文件夹根目录下找。
- 如果你的虚拟环境不在项目根目录（比如建在
~/pyenvs/myproject），必须手动添加路径 - Windows 下路径含空格或中文不会报错，但某些扩展（如 Pylance）可能解析异常，建议路径纯英文 + 无空格
- 激活过的
venv不代表 VSCode 就认得——它只看路径，不看是否激活 - 确认路径正确：进入你的
venv文件夹，Scripts/python.exe（Windows）或bin/python（macOS/Linux）就是你要选的解释器
怎么选中 conda 环境里的 Python 解释器
VSCode 对 conda 支持依赖于 conda 命令是否在 PATH 中，且要求 conda 环境已通过 conda create 创建完成（不是仅 pip install 出来的环境）。
- 先在终端运行
conda env list，复制目标环境的完整路径（比如/opt/anaconda3/envs/py39） - 对应解释器路径是：
envs/py39/bin/python（macOS/Linux）或envspy39python.exe（Windows） - 别选 base 环境的 python——除非你真想全局开发；base 环境容易因升级损坏，也不利于隔离依赖
- 如果 VSCode 列表里没出现 conda 环境，大概率是没装 Python 扩展，或
conda命令不可达（比如 zsh 里能用，但 VSCode 启动时用的是 bash 且没配置好）
为什么选对了解释器，import 还是报错
解释器路径设对了，只是第一步；VSCode 的 Python 扩展还会单独读取 python.defaultInterpreterPath 和工作区设置，而 linting、debugging、Jupyter kernel 是各自独立加载环境的。
立即学习 “Python 免费学习笔记（深入）”；
- 检查左下角状态栏是否显示你选的解释器路径（点击可重新选择）
- 重启 VSCode —— 很多时候改完解释器不重启，Pylance 仍缓存旧环境的类型信息
- Jupyter Notebook 单元格右上角有个 kernel 下拉菜单，它和编辑器解释器不是一回事，要单独点选匹配的 kernel
- 如果用了
poetry或pipenv，它们生成的 venv 路径不标准，VSCode 默认找不到，得手动指向poetry env info --path输出的路径
怎么避免每次新建项目都重新配解释器
VSCode 没有全局“默认 Python 解释器”设置，工作区设置（.vscode/settings.json）优先级高于用户设置，所以项目级配置最容易被覆盖或忽略。
- 在项目根目录创建
.vscode/settings.json，写入：{"python.defaultInterpreterPath": "./venv/bin/python"}（路径按实际调整）
- 别把解释器路径写死成绝对路径（如
/home/user/……）——别人 clone 项目就失效 - 如果团队协作，建议用
venv+requirements.txt，而不是 conda —— 后者环境路径不一致，共享配置容易出问题 - VSCode 1.85+ 支持
python.defaultInterpreterPath设为变量，比如"${workspaceFolder}/.venv/bin/python"，但仅限于基础变量，不支持 shell 命令展开
最常被忽略的一点：改了解释器后，VSCode 可能还在用旧的 PYTHONPATH 或 sys.path 缓存，尤其当你从 conda 切到 venv 时，Pylance 的类型提示会卡在旧环境里，这时候不光要重启窗口，还得清一下 ~/.vscode/extensions/ms-python.python-*/out/…… 下的缓存（或者直接删掉扩展重装）。
