vscode 找不到 poetry 虚拟环境是因为它不自动扫描 poetry 默认缓存路径，必须手动指定完整解释器路径（如 macos 的 /path/to/venv/bin/python 或 windows 的 \scripts\python.exe），并写入 .vscode/settings.json 且重启窗口。
VSCode 为什么找不到 Poetry 虚拟环境
VSCode 根本不扫描 ~/Library/Caches/pypoetry/virtualenvs/（macOS）或 %LOCALAPPDATA%\pypoetry\Cache\virtualenvs\（Windows）这些 Poetry 默认缓存路径——它只认你明确告诉它的那个 python 可执行文件。不是插件没装好，也不是 Poetry 没生效，而是 VSCode 压根没看到那个环境。
常见错误现象：
- 右下角状态栏显示的是
/usr/bin/python3或其他系统/旧 venv 路径，而非 Poetry 环境 -
poetry install成功，但 VSCode 里import requests依然标红 - 调试时抛
ModuleNotFoundError，但终端里poetry run python -c "import requests"正常
如何获取并拼出正确的 Poetry 解释器路径
必须在项目根目录下运行命令，否则返回的是别的项目的环境路径；poetry env info --path 输出的只是根目录，不是解释器本身。
- 先运行：
poetry env info --path（输出类似/Users/me/Library/Caches/pypoetry/virtualenvs/myproj-abc123-py3.11） - macOS/Linux 补上：
/bin/python→ 完整路径是/Users/me/Library/Caches/pypoetry/virtualenvs/myproj-abc123-py3.11/bin/python - Windows 补上：
\Scripts\python.exe或/Scripts/python.exe（正斜杠也兼容）→ 完整路径是C:\Users\me\AppData\Local\pypoetry\Cache\virtualenvs\myproj-abc123-py3.11\Scripts\python.exe - 别信
which python或poetry shell后终端里显示的路径——它可能被pyenv、shell alias 或旧PATH干扰
在 VSCode 中手动设置并固化该路径
VSCode 默认下拉列表几乎不会出现 Poetry 环境，靠“猜”或“选列表里的 (venv)”大概率失败；输错路径（比如漏了 /bin/python）会静默 fallback 到上一个解释器，且不报错——这是最常被忽略的失效点。
- 按
Cmd+Shift+P（macOS）或Ctrl+Shift+P（Windows/Linux），输入并选择Python: Select Interpreter - 务必点击
Enter interpreter path，粘贴上面拼好的完整路径 - 编辑项目根目录下的
.vscode/settings.json，加入这一行（路径必须和poetry env info --path输出完全一致）："python.defaultInterpreterPath": "/full/path/to/venv/bin/python" - 保存后，**必须关闭并重新打开整个 VSCode 窗口**（不是 “Developer: Reload Window”），否则 Pylance 和 debugger 仍缓存旧环境
调试和运行时仍要用 poetry run
VSCode 的 Python 扩展不读取当前终端的激活状态，即使你开了 poetry shell，编辑器进程、调试器、任务仍走自己选中的解释器。所以不能依赖 shell 继承。
- 调试配置（
.vscode/launch.json）中，python字段必须指向你刚设好的解释器路径，而不是靠poetry shell临时切换 - 运行脚本时，推荐用
poetry run python script.py，而非直接python script.py—— 这能确保环境变量、PATH、site-packages 全部对齐 - 如果写成任务（
.vscode/tasks.json），command 应为poetry run python，而不是python
poetry env info --path 重新确认，以及把拼好的完整解释器路径硬编码进 .vscode/settings.json。Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
