VSCode必须手动指定Python解释器完整路径，否则import报错、调试断连、补全失效；按Ctrl+Shift+P输入“Python: Select Interpreter”选择带明确路径的项，右下角确认显示，配置仅对工作区生效。
VSCode 不会自动继承你终端里激活的 Python 环境，也不扫描整个磁盘找 python，必须手动指定解释器的**完整可执行文件路径**——选错或漏配，import 就报错、调试就断连、Pylance 补全就失效。
Python: Select Interpreter 命令面板怎么用
这是最常用也最容易出错的第一步。按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入并选择 Python: Select Interpreter：
- 列表里优先选带明确路径的项，比如
./.venv/bin/python（macOS/Linux）或.\.venv\Scripts\python.exe（Windows），别选只有python3或Python 3.12这种模糊名称的条目 - 如果列表为空，点
Enter interpreter path...，然后手动粘贴路径——可用终端命令查：which python（macOS/Linux）、where python（Windows）、conda env list（conda 环境） - 选完后，立刻看 VSCode 窗口**右下角状态栏**是否显示对应路径；没变？不是设置失败，是窗口没刷新——关掉再重开整个 VSCode 窗口（不是标签页）
venv 路径为什么 VSCode 找不到
VSCode 默认只在项目根目录下检查几个固定名的文件夹：.venv、venv、env，且**不递归扫描子目录**。常见踩坑点：
- 你在
~/pyenvs/myproject创建了 venv，但打开的是~/myproject文件夹 → VSCode 根本看不到它 - 你用了
python -m venv myenv（名字不是.venv或venv）→ 默认不识别，得手动输路径 - 路径含中文或空格（如
C:\Users\张三\project\.venv\Scripts\python.exe）→ 大部分功能正常，但 Pylance 可能解析失败、类型提示丢失 - 你用
poetry或pipenv创建环境 → 它们生成的路径不标准，需运行poetry env info --path或pipenv --venv拿到真实路径再手动填
conda 环境列不出来怎么办
VSCode 的 Python 扩展依赖 conda 命令本身可达，且默认只扫描标准 conda 安装路径下的 envs/ 目录：
SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、
立即学习“Python免费学习笔记（深入）”；
- 如果你用的是
micromamba、miniforge或自定义安装路径（比如 Windows 上装在D:\Miniconda3），VSCode 可能根本找不到conda env list输出的环境 - 确保
conda在终端里能直接运行，且 VSCode 启动时用的 shell（bash/zsh/fish）和你终端一致；Mac 用户尤其注意：VSCode 可能用 bash 启动，而你日常用 zsh，PATH里没导出 conda →conda command not found - 别选
base环境，除非你真要全局开发；它容易被升级破坏，也不利于隔离依赖 - 确认 conda 环境已真正创建完成（
conda create -n myenv python=3.11），而不是仅用pip install往 base 里塞包
选对了解释器，import 还是红波浪线
解释器路径设对，只是起点。VSCode 里多个组件各自加载环境，互不自动同步：
- 左下角状态栏显示的解释器，只管编辑器补全和静态分析（Pylance）；Jupyter Notebook 的 kernel 是独立配置的，右上角 kernel 下拉菜单必须单独点选匹配项
- 集成终端默认启动的是系统 shell 环境，不是你选的 Python 解释器所在环境；想让它自动激活虚拟环境，得在终端右上角下拉菜单里选「Python」选项（前提是解释器已正确识别）
-
launch.json中如果写死了"python"或绝对路径，会覆盖解释器选择；建议留空，让 VSCode 自动继承当前工作区设置 - 改完解释器后，Pylance 缓存不会自动更新 → 必须重启 VSCode 窗口，否则补全、跳转、类型提示都还是旧环境的
最常被忽略的一点：VSCode 的 Python 配置是**工作区级**的，保存在项目根目录的 .vscode/settings.json 里；没有这个文件，或者你打开的是单个 .py 文件而非整个文件夹，所有设置都不生效。
