如何用 poetry python install 管理 Python 版本并用于项目【免费下载链接】poetryPython packaging and dependency management made easy项目地址: https://gitcode.com/GitHub_Trending/po/poetry如果你的项目要求的 Python 版本系统里没有又不想借助 pyenv 这类外部工具Poetry 2.1.0 起提供的poetry python命令组可以直接从 Python Standalone Builds 项目安装指定版本并用它创建、运行当前项目的虚拟环境。适用前提已安装 PoetryPoetry 本身要求 Python 3.10并且版本达到 2.1.0 以上。需要说明的是官方文档标注python命令组是实验性功能后续版本可能改变行为。准备条件已安装可用的 Poetry。文档给出的安装方式包括 pipxpipx install poetry和官方安装脚本详见 docs/_index.md可用poetry --version确认python命令组需要 2.1.0 及以上版本。项目根目录存在pyproject.toml。Poetry 创建虚拟环境时默认使用安装 Poetry 所用的 Python 版本如果该版本与项目pyproject.toml中声明的python版本范围不兼容Poetry 会尝试寻找一个兼容版本找不到时会提示你显式指定见 docs/managing-environments.md。查看环境里有哪些 Python 版本先用python list确认当前环境已经安装了哪些 Python。它会同时列出 System managed系统管理和 Poetry managedPoetry 管理的安装poetry python list可选参数--all (-a)列出所有版本包括可下载但尚未安装的--managed (-m)只列出 Poetry 管理的版本--implementation (-i)按实现筛选cpython、pypy--free-threaded (-t)只列出 free-threaded 版本。如果目标版本只在--all输出中出现而不在默认输出中说明它可下载但还没有安装下一步执行安装。安装指定 Python 版本在需要的项目目录或任意目录安装的是 Poetry 全局管理的版本执行poetry python install 3.11其中3.11需要替换为你要安装的版本号版本来源是 Python Standalone Builds 项目。常用选项参数含义以 docs/cli.md 为准# 安装 free-threaded 版本等价于请求版本号带 t 后缀的版本 poetry python install 3.11 -t # 指定实现 poetry python install 3.11 --implementation pypy # 若已存在该安装则重新安装 poetry python install 3.11 --reinstall # 安装检查失败时清理本次安装 poetry python install 3.11 --cleanPoetry 管理的 Python 版本默认安装到{data-dir}/python目录。需要自定义时可用配置项python.installation-dir2.1.0 引入或设置环境变量POETRY_PYTHON_INSTALLATION_DIR见 docs/configuration.md。安装完成后用python list复核该版本应出现在输出中且poetry python list --managed能单独列出它。让项目使用新安装的版本poetry python install只负责装好解释器还要告诉 Poetry 当前项目用它。env use接受完整路径、可执行文件名或简写的小版本号非 Windows 下# 使用刚安装的版本 poetry env use 3.11 # 如果可执行文件在 PATH 中 poetry env use python3.11env use会为当前项目激活或创建对应版本的虚拟环境。装完版本后执行poetry install即可按pyproject.toml解析依赖并装入该环境若当前目录已有poetry.lock则按锁文件中的精确版本安装。如果以后想撤销显式指定、恢复默认行为默认用系统/安装 Poetry 时的 Python使用特殊值systempoetry env use system验证环境生效poetry env info文档给出的示例输出如下实际输出中的 Python 版本和 Path 取决于你激活的环境Virtualenv Python: 3.7.1 Implementation: CPython Path: /path/to/poetry/cache/virtualenvs/test-O3eWbxRl-py3.7 Valid: True Base Platform: darwin OS: posix Python: /path/to/main/python重点看Python一行是否为刚安装的版本。其他验证方式poetry env info --path只输出虚拟环境路径poetry env info --executable只输出环境内 python 可执行文件路径poetry env list列出项目关联的所有虚拟环境当前激活的会带(Activated)标记加--full-path可显示完整路径poetry run python -V在项目虚拟环境中执行命令确认实际运行的解释器版本。清理不需要的版本与环境不再需要某个 Poetry 管理的 Python 版本时poetry python remove 3.11 poetry python remove 3.11 --free-threaded poetry python remove 3.11 --implementation pypy该命令只移除 Poetry 管理的版本不影响系统自带的 Python。移除版本后项目对应的虚拟环境仍可单独删除poetry env remove 3.11 poetry env remove --all一次可移除多个环境若删掉的是当前激活的环境它会被自动停用。若你启用了virtualenvs.in-project配置直接执行poetry env remove不带参数即可移除项目内虚拟环境。限制与替代路径poetry python命令组是实验性功能文档明确提示后续版本可能改变行为。自 Poetry 1.2 起Poetry 不再支持为 Python 2.7 管理环境。如果你更习惯用 pyenvdocs/managing-environments.md 给出的是pyenv installpyenv local后执行poetry install的工作流在 pyenv 不可用的系统如 Windows上poetry python installpoetry env use是文档推荐的替代路径。两条路径完成后都通过poetry env info和poetry run python -V确认项目实际使用的解释器版本这一步是判断整条操作链是否成功的依据。【免费下载链接】poetryPython packaging and dependency management made easy项目地址: https://gitcode.com/GitHub_Trending/po/poetry创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考