VSCode无法自动识别conda或venv环境，需手动指定解释器路径；conda环境必须通过conda init shell后重启VSCode才能被探测，venv则需置于项目根目录并命名为.venv，且路径须指向python可执行文件而非文件夹。
VSCode 不能自动识别你创建的 conda 或 venv 环境，必须手动指定解释器路径——选错、漏选、路径写成绝对路径，都会导致补全失效、ModuleNotFoundError、调试跑错环境。
Python: Select Interpreter 找不到 .venv 或 conda 环境
VSCode 默认只扫描项目根目录下几个固定名：.venv、venv、env，且要求结构完整（含 pyvenv.cfg 和可执行的 python）。conda 环境则完全不被自动发现，除非 conda 命令在终端中可用。
- 用
python -m venv .venv创建（注意是.venv，不是venv），这是 VSCode 最优先识别的名称 - conda 环境必须手动输入绝对路径：
~/miniconda3/envs/myenv/bin/python（macOS/Linux）或C:\Users\Name\Miniconda3\envs\myenv\python.exe（Windows） - 路径里不能含空格或中文，否则 Pylance 可能解析失败；建议统一用
.venv，Git 和 VSCode 默认忽略它 - 如果路径正确却仍不显示，先在系统终端运行
conda env list或ls .venv/bin/，确认python可执行文件真实存在
VSCode 终端里 conda activate 不起作用
这不是 VSCode 的 bug，而是 shell 初始化脚本未加载。VSCode 内置终端默认不 source ~/.zshrc 或 ~/.bashrc，所以 conda activate 命令根本不可用。
- 在系统终端（非 VSCode 里）运行
conda init zsh（zsh 用户）或conda init bash（bash 用户） - 关闭并重启 VSCode，确保新终端进程读取了更新后的 shell 配置
- 打开新终端后，先执行
conda env list，看到列表再conda activate myenv - 此时再运行
Python: Select Interpreter，就能自动检测到当前激活的 conda 环境
选对解释器后终端仍不自动激活
选对解释器只是第一步。VSCode 的集成终端默认不激活虚拟环境，pip install 仍可能装到全局。必须配齐两个设置：
python-script-generator
下载
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
立即学习“Python免费学习笔记（深入）”；
-
python.defaultInterpreterPath已在.vscode/settings.json中正确写入（如"./.venv/bin/python"） -
python.terminal.activateEnvironment设为true（默认是 true，但有时被用户级设置覆盖） - 改完设置后重启 VSCode——Pylance 会缓存旧环境的类型信息，不重启补全仍不准
- Jupyter Notebook 的 kernel 是独立配置的，右上角 kernel 下拉菜单必须手动选匹配的
.venv环境，和编辑器解释器无关
验证是否真生效：别信状态栏，要看 sys.executable
状态栏显示 Python 3.x ('.venv': venv) 并不可靠。真正生效的唯一证据是：
- 新建
test.py，写import sys; print(sys.executable)，运行输出路径必须包含.venv或你的 conda 环境路径 - 在集成终端中运行
pip list，只应看到基础包（pip、setuptools），没有你全局装的包 - 如果用了
src/目录结构，launch.json中需显式加"cwd": "${workspaceFolder}/src"，否则调试时可能因工作目录不对而报ModuleNotFoundError - conda 环境若在 Jupyter 中 import 报错，大概率是没装
ipykernel：运行conda activate myenv && pip install ipykernel && python -m ipykernel install --user --name myenv --display-name "Python (myenv)"
最常被忽略的是：VSCode 启动时读取的 PATH 和你在终端里 which python 看到的 PATH 不一定一致——关掉再重开 VSCode 才能刷新环境变量。还有，.venv 必须放在你用 VSCode “打开文件夹” 所选的那个根目录下，套在子目录里（比如 project/envs/.venv）VSCode 就直接无视。
