先手动触发“Python: Select Interpreter”并指定.venv/bin/python或.venvScriptspython.exe路径，再重启VSCode窗口；确认.venv位于项目根目录、检查launch.json中python字段是否指向虚拟环境内解释器，且终端、调试器、语言服务器、测试框架四者环境需分别验证一致。

VSCode 识别不到 .venv 解释器怎么办

VSCode 没自动发现刚创建的 .venv，不是插件坏了，而是它只扫描特定位置或需手动触发。常见现象是状态栏显示系统 Python，pip list 却看不到刚装的包。

• 先确认 .venv 确实存在且非空（里面有 bin/ 或 Scripts/ 子目录）
• 按 Ctrl+Shift+P → 输入 Python: Select Interpreter，别只看列表顶部，往下滚动或直接点击“Enter interpreter path…”
• 手动导航到：.venv/bin/python（macOS/Linux）或 .venvScriptspython.exe（Windows）
• 选完后，**重启 VSCode 窗口**（仅 reload window 不够），否则调试器和终端可能仍用旧解释器

pip install 装的包在 VSCode 里不提示

这说明编辑器没绑定到当前虚拟环境，或者安装时环境没激活。补全失效 ≠ 包没装上，而是 VSCode 的语言服务器不知道该查哪份 site-packages。

• 检查终端左下角状态栏是否显示类似 Python 3.11.9 ('.venv': venv) —— 没这个就等于没绑定
• 不要在未激活的终端里运行 pip install，否则包会装进系统 Python
• 如果已绑定但补全仍不工作，执行 Ctrl+Shift+P → Python: Restart Language Server
• 某些包（如 C 扩展类库）需要重启 VSCode 才能被 Pylance 正确索引

多个项目共用一个 .venv 目录？绝对不行

把 .venv 放错位置（比如放在用户主目录或父级文件夹）会导致所有子项目共享同一套依赖，这是隐蔽的灾难源头。

提示词大师-python版

图片提示词生成器？不止如此。 马甲系统 —— 把脑海中的画面，翻译成AI能理解的专业表达。 用得越多，它越懂你：首次需要多问几句确认方向，用久了几乎一说就懂。 用得越多，它越快：缓存机制让后续对话越来越省。 RAG进化：成功案例持续入库，越跑越聪明。 输入「新手指南」查看完整功能介绍

下载

• .venv 必须放在**每个项目的根目录下**，且项目根目录 = 含 pyproject.toml 或 requirements.txt 的那个文件夹
• VSCode 工作区（workspace）的根路径决定它默认找哪个 .venv；打开错误的文件夹，它就会绑定错环境
• 如果误删了 .venv，别试图复制粘贴另一个项目的环境目录——路径硬编码在里面，直接失效
• 正确做法：删掉旧 .venv → python -m venv .venv → pip install -r requirements.txt

调试时还是跑系统 Python？检查 launch.json

F5 调试跑错解释器，往往是因为 .vscode/launch.json 里没显式指定路径，VSCode 默认用当前选中的解释器——但这个“当前”可能被其他操作覆盖。

立即学习“Python免费学习笔记（深入）”；

• 打开 .vscode/launch.json，确保 python 字段指向虚拟环境内的解释器，例如：
  "python": "./.venv/bin/python"（Linux/macOS）或
  "python": ".\.venv\Scripts\python.exe"（Windows）
• 不要写成 "python": "python"，这会退化为 shell PATH 查找，极大概率调用系统 Python
• 如果项目含多个 .py 入口，不同 launch 配置要各自指定 python 路径，不能复用全局设置
• 改完配置后，务必用调试面板右上角的齿轮图标重新加载配置，而不是直接点绿色三角形

真正容易被忽略的是：VSCode 的终端、调试器、语言服务器、测试框架这四者各自维护一套环境绑定逻辑，它们**不自动同步**。哪怕你选对了解释器，也可能某个环节悄悄回退。每次遇到奇怪行为，优先验证这四个地方是否全部指向同一个 .venv 路径。