VSCode需手动指定Poetry虚拟环境中的真实Python解释器路径，否则导致import报错、调试失败和Pylance失效；应运行poetry env info --path获取根目录，再拼接/bin/python（macOS/Linux）或\Scripts\python.exe（Windows），通过Python: Select Interpreter粘贴完整路径，并在.settings.json中固化配置，最后整窗口重启生效。
VSCode 不会自动识别 Poetry 创建的虚拟环境，必须手动指定 python 可执行文件路径，否则 import 报错、调试失败、Pylance 类型提示全失效——这不是插件没装好，是解释器根本没对齐。
确认 Poetry 环境已创建并获取真实解释器路径
在项目根目录下运行：poetry env info --path
输出的是虚拟环境根目录（如 /Users/me/Library/Caches/pypoetry/virtualenvs/myproj-abc123-py3.11），它本身不是解释器。
- macOS/Linux 下真实解释器是：
<path>/bin/python</path> - Windows 下真实解释器是：
<path>\Scripts\python.exe</path> - 别用
which python或poetry shell后终端里显示的路径——可能被pyenv、shell alias 或旧 PATH 干扰 - 必须在项目根目录运行该命令，否则返回的是其他项目的环境路径
在 VSCode 中手动选择 Poetry 解释器
按 Ctrl+Shift+P（macOS 是 Cmd+Shift+P），输入并选择 Python: Select Interpreter。
- 不要从下拉列表里“猜”——VSCode 默认不扫描 Poetry 缓存目录，列表里几乎不会出现 Poetry 环境
- 务必点击
Enter interpreter path - 粘贴拼好的完整路径，例如：
/Users/me/Library/Caches/pypoetry/virtualenvs/myproj-abc123-py3.11/bin/python - 输错路径（比如漏了
/bin/python）时，VSCode 会静默 fallback 到上一个解释器，且不报错——这是最常被忽略的失败点
固化配置到 .vscode/settings.json
每次切换分支、重装依赖、甚至重启 VSCode，都可能丢失解释器选择。靠手点不可靠，必须写死配置。
- 在项目根目录创建或编辑
.vscode/settings.json - 加入这一行（注意 Windows 路径可用双反斜杠或正斜杠，但必须和
poetry env info --path输出完全一致）："python.defaultInterpreterPath":"/full/path/to/venv/bin/python" - 保存后，**必须关闭并重新打开整个 VSCode 窗口**（不是 “Developer: Reload Window”），否则 Pylance 和 debugger 仍缓存旧环境
验证是否生效 & 常见失效现象
右下角状态栏显示的解释器路径，必须是带 virtualenvs 的那个完整路径，而不是 /usr/bin/python3 或其他 venv。
-
poetry install成功但 VSCode 里import requests标红？→ 解释器没对齐 - 终端里
poetry run python -c "import mypackage"没问题，但 VSCode 调试时报ModuleNotFoundError？→ 调试器没走 Poetry 环境 - 点了
Python: Select Interpreter却发现右下角没变？→ 可能路径拼错，或没重启窗口 - 用了
poetry shell再开 VSCode？别依赖这个——VSCode 进程不继承终端激活状态
最易被忽略的细节：路径必须精确到 /bin/python 或 \Scripts\python.exe，且 .vscode/settings.json 配置后必须整窗体重启。Poetry 环境路径本身是动态生成的，硬编码虽然看起来不优雅，但目前是唯一稳定方案。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
