poetry install 用错 python 版本的根本原因是它不自动匹配 pyproject.toml 中的 requires-python，也不主动安装所需解释器，仅检查本地已有版本是否满足范围。
poetry install 为什么总是用错 Python 版本
根本原因：poetry 默认不自动匹配 pyproject.toml 中的 requires-python，也不会主动安装对应解释器——它只检查本地已有版本是否满足范围，不负责“补齐”。
常见错误现象：poetry install 成功但运行时报 ModuleNotFoundError 或 AttributeError，其实是用了系统默认的旧版 Python（比如系统自带的 3.9），而项目依赖需要 3.11+ 的语法或库。
- 先确认项目要求：
grep requires-python pyproject.toml，例如得到requires-python = "^3.11" - 手动指定解释器再初始化环境：
poetry env use 3.11（前提是本机已装 3.11；若未装，poetry 不会帮你装） - 验证当前环境：
poetry env info --path和poetry run python --version必须一致且符合要求 - 如果
poetry env use 3.11报错Can't find a Python interpreter，说明本机没装该版本——poetry 不管安装 Python，得自己用 pyenv、asdf 或系统包管理器装好再说
pyenv + poetry 混用时 poetry shell 进不去正确环境
本质是 shell 层级和 PATH 覆盖顺序问题：pyenv 通过 shims 注入 PATH，而 poetry 创建的虚拟环境路径优先级可能被覆盖。
使用场景：你用 pyenv local 3.11.8 切换项目 Python，也执行了 poetry env use 3.11.8，但 poetry shell 后 which python 仍指向 pyenv shim 而非 poetry 虚拟环境里的 Python。
立即学习“Python免费学习笔记（深入）”；
- 关键动作：在进入 shell 前，先确保 poetry 环境已激活且绑定到当前项目：
poetry env use $(pyenv which python) - 避免手动改
PYTHONPATH或PATH，容易破坏 poetry 的路径隔离逻辑 - 检查
poetry env list输出中带(activated)的那行，才是当前生效环境 - 如果仍异常，临时退出 pyenv（
pyenv shell --unset）再试poetry shell，可快速验证是否为 pyenv shim 干扰
poetry add 后依赖没进对的 Python 环境
这不是 poetry 的 bug，而是它严格按当前激活环境操作——如果你没显式指定或没成功激活目标 Python 版本环境，poetry add 就会把包装进“默认”环境（通常是最早创建的那个，未必是你想要的）。
性能影响：不同 Python 版本间不共享 site-packages，装错环境会导致 poetry install 重复构建、磁盘占用翻倍，甚至因编译 ABI 不兼容报 ImportError: undefined symbol。
- 每次
poetry add前，先运行poetry env info --path确认路径是否含预期版本号（如.../3.11.8） - 不要依赖
poetry init自动生成的环境——它可能用的是系统默认 Python，务必紧接着poetry env use x.y - CI/CD 中尤其要注意：Docker 镜像里若预装多个 Python，
poetry install可能静默选错，建议显式写成poetry env use 3.11 && poetry install
Windows 上 poetry env remove 删不干净
Windows 的文件锁机制导致 poetry 删除虚拟环境目录时，常卡在 Scripts\python.exe 被占用，残留空目录或只删了部分子目录。
容易踩的坑：你以为删掉了旧环境，结果 poetry env list 还显示它，或者下次 poetry install 复用残留目录，引发路径错乱或权限错误。
- 关掉所有 PowerShell / CMD / VS Code 终端窗口，尤其是曾执行过
poetry shell的 - 任务管理器里杀掉所有
python.exe和py.exe进程（哪怕看起来无关） - 手动删除前先运行：
poetry env remove $(poetry env info --name)，而不是直接rm -rf目录 - 如果仍失败，用
poetry env use --remove（Poetry 1.7+ 支持）强制解除绑定，再删物理目录
--dry-run 查看将用哪个环境。每次操作前多敲一行 poetry env info，比事后 debug 快得多。 
