VSCode根本看不到Poetry虚拟环境，因其不扫描Poetry默认缓存目录（如~/Library/Caches/pypoetry/virtualenvs/），仅识别预设路径或手动指定路径；必须运行poetry env info --path获取真实路径，再拼上/bin/python或\Scripts\python.exe，通过“Python: Select Interpreter→Enter interpreter path”手动输入完整解释器路径，并在.vscode/settings.json中固化配置且重启窗口生效。
VSCode 为什么根本看不到 Poetry 的虚拟环境
VSCode 不扫描 Poetry 的缓存目录，它只认自己预设的路径（如 ./venv、.virtualenvs）或你手动告诉它的路径。Poetry 默认把环境存在系统级缓存里：~/Library/Caches/pypoetry/virtualenvs/（macOS）、%LOCALAPPDATA%\pypoetry\Cache\virtualenvs\（Windows）、~/.cache/pypoetry/virtualenvs/（Linux），这些位置 VSCode 启动时压根不会去翻。
更关键的是：Poetry 创建的环境是“无名”的——没有 pyvenv.cfg 里的 prompt 字段，也不在 VSCode 的自动发现白名单里。所以即使你运行过 poetry install，命令面板里 Python: Select Interpreter 列表依然空空如也。
必须用 poetry env info --path 获取真实路径
别猜、别翻文件夹、别依赖 poetry shell 后的终端状态。唯一可靠的方式是让 Poetry 自己告诉你路径：
- 在项目根目录下运行
poetry env info --path，输出类似/Users/you/Library/Caches/pypoetry/virtualenvs/myproject-py3.11（macOS）或C:\Users\you\AppData\Local\pypoetry\Cache\virtualenvs\myproject-py3.11（Windows） - 这个路径只是环境根目录，不是 Python 解释器本身——你要手动拼上可执行文件：
• macOS/Linux 补/bin/python
• Windows 补\Scripts\python.exe - 最终完整路径应为：
/Users/you/Library/Caches/pypoetry/virtualenvs/myproject-py3.11/bin/python或C:\Users\you\AppData\Local\pypoetry\Cache\virtualenvs\myproject-py3.11\Scripts\python.exe
选解释器时不能只粘路径，必须进对菜单项
很多人卡在这一步：复制了 poetry env info --path 输出，打开 Python: Select Interpreter，却直接在列表里乱点，或者误选了 “Enter interpreter path” 但输错了子路径。
正确操作顺序：
- 按
Ctrl+Shift+P（macOS 是Cmd+Shift+P），输入并选择Python: Select Interpreter - 在弹出列表中，**不要点已有选项**，而是向下滚动到底部，选
Enter interpreter path...（注意省略号） - 粘贴完整路径（含
/bin/python或\Scripts\python.exe），回车确认 - VSCode 底部状态栏会立刻显示该路径——这才是真正生效的解释器
如果点错成 “Enter interpreter path” 但没带 bin/ 或 Scripts/，VSCode 会报错或静默失败，且不会提示你哪里错了。
避免每次重开项目都重复设置
每次打开新窗口都要手动选一次？不是必须的。把路径写进项目级配置就能固化：
- 确保项目根目录有
.vscode/settings.json（没有就新建） - 在里面加一行：
"python.defaultInterpreterPath": "/full/path/to/venv/bin/python"（Windows 用正斜杠或双反斜杠均可） - 路径必须和
poetry env info --path输出一致，不能少字符、不能多空格 - 改完保存，**重启整个 VSCode 窗口**（不是重载窗口），否则 Pylance 和调试器可能仍用旧环境缓存
注意：这个配置只对当前工作区生效；如果你用多根工作区（multi-root workspace），每个文件夹都要单独配。Poetry 环境路径一旦变更（比如重装依赖或换 Python 版本），poetry env info --path 输出就会变，.vscode/settings.json 里的路径也得同步更新——这是最容易被忽略的维护点。
