VSCode无法自动识别Poetry虚拟环境，需手动通过“Python: Select Interpreter”指定poetry env info --path输出路径并补全python可执行文件路径，且每次环境变更后须重新设置。
VSCode 识别不了 Poetry 创建的虚拟环境？先确认解释器路径是否在 poetry env info --path 输出里
VSCode 不会自动扫描 Poetry 的虚拟环境目录，它只认你手动指定或它自己发现的 python 可执行文件路径。Poetry 默认把环境存在缓存目录（比如 ~/Library/Caches/pypoetry/virtualenvs/ 或 %LOCALAPPDATA%\pypoetry\Cache\virtualenvs\），不是项目根目录下的 .venv，所以 VSCode 打开项目时大概率找不到。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 在项目根目录运行
poetry env info --path，复制输出的完整路径 - 在 VSCode 中按
Ctrl+Shift+P（macOS 是Cmd+Shift+P），输入 “Python: Select Interpreter”，回车 - 选 “Enter interpreter path...”，粘贴刚才复制的路径，再补上
/bin/python（macOS/Linux）或\Scripts\python.exe（Windows） - 确认后，VSCode 底部状态栏会显示该解释器路径，且
import行为、调试、linter 都会基于这个环境生效
用 poetry shell 进入环境后 VSCode 还是用错解释器？别依赖终端继承
VSCode 的 Python 扩展默认不读取当前终端的 PYTHONPATH 或激活状态，即使你在终端里跑了 poetry shell，VSCode 的编辑器进程、调试器、任务仍走自己选中的解释器。这是常见误解点。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 不要靠“先开 shell 再开 VSCode”来“骗过”解释器识别
- 务必通过
Python: Select Interpreter显式设置，哪怕路径看起来很长 - 如果项目有
.vscode/settings.json，可加这一行避免每次重选："python.defaultInterpreterPath": "/full/path/to/venv/bin/python"
（路径必须和poetry env info --path输出一致） - 改完设置后重启 VSCode 窗口（不是重载窗口），否则部分功能（如 Pylance 类型推导）可能仍缓存旧环境
poetry install 后 VSCode 还提示模块未安装？检查是不是用了系统 Python 或旧环境
错误现象：明明 poetry install 成功了，import requests 在 VSCode 里却标红，运行时报 ModuleNotFoundError，但终端里 poetry run python -c "import requests" 没问题。
根本原因通常是解释器没对齐：VSCode 当前选的是系统 Python、旧 venv，甚至另一个 Poetry 环境。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 看 VSCode 窗口右下角——那里显示的才是当前生效的解释器路径，点它，确认和
poetry env info --path一致 - 在 VSCode 终端里运行
which python（macOS/Linux）或where python（Windows），输出应指向 Poetry 环境里的python，否则说明终端和编辑器解释器不统一（此时要关掉终端再重开） - 如果用了多根工作区（multi-root workspace），每个文件夹都要单独设置解释器，VSCode 不会跨文件夹继承
想让新项目自动用 Poetry 环境？别指望 VSCode 自动发现，得靠 poetry init + 手动绑定
VSCode 没有“检测到 pyproject.toml 就自动配 Poetry 解释器”的逻辑。哪怕你刚跑完 poetry init，它也不会主动弹窗问“要选这个环境吗？”
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 初始化后立刻执行
poetry install，确保环境生成出来 - 立刻运行
poetry env info --path，记下路径 - 立刻进 VSCode 设置解释器——越早绑定，越少遇到 import 错误、类型提示失效、测试发现不了包等问题
- 如果团队协作，把解释器路径写进
.vscode/settings.json并提交（注意路径含用户名或绝对路径，需用相对方式或文档说明，不推荐硬编码绝对路径）
poetry env remove 或 poetry env use 后，VSCode 里的解释器设置就失效了——这点最容易被忽略。 
