Poetry 常用命令速查

文章目录核心命令对比2.0 vs 1.x常用命令速查项目初始化依赖管理环境管理安装与同步2.0 重要变化运行与构建版本管理调试与检查需要安装插件的命令2.0 变化导出 requirements.txt激活虚拟环境 shell常用工作流示例2.0 最重要的新命令sync核心命令对比2.0 vs 1.x功能Poetry 2.0 命令说明安装依赖poetry install与 1.x 相同同步环境poetry sync新增更严格的install会移除多余包添加依赖poetry add与 1.x 相同更新依赖poetry update与 1.x 相同导出 requirements.txt需安装poetry-plugin-export不再是内置命令激活虚拟环境需安装poetry-plugin-shell不再是内置命令常用命令速查项目初始化poetry new my-project# 创建新项目poetry init# 在现有目录初始化依赖管理poetryaddrequests# 添加生产依赖poetryaddpytest--groupdev# 添加开发依赖poetry remove requests# 移除依赖poetry show# 查看已安装包poetry show--tree# 树形查看依赖关系poetry show--outdated# 查看可更新的包环境管理poetryenvuse python3.10# 指定 Python 版本poetryenvinfo# 查看虚拟环境信息poetryenvlist# 列出所有虚拟环境poetryenvremove env-name# 删除虚拟环境安装与同步2.0 重要变化poetryinstall# 安装 lock 文件中的依赖poetryinstall--no-root# 不安装项目本身poetryinstall--onlymain# 只安装 main 依赖组poetryinstall--withdev# 包含 dev 依赖组poetryinstall--withoutdev# 排除 dev 依赖组poetrysync# 【2.0 新增】同步环境移除不在 lock 中的包poetrysync--onlydev# 只同步 dev 组运行与构建poetry run python script.py# 在虚拟环境中运行脚本poetry build# 构建分发包.whl 和 .tar.gzpoetry publish# 发布到 PyPI版本管理poetry version# 查看当前版本poetry version patch# 升级补丁版本 (1.0.0 → 1.0.1)poetry version minor# 升级次版本 (1.0.0 → 1.1.0)poetry version major# 升级主版本 (1.0.0 → 2.0.0)调试与检查poetry check# 检查 pyproject.toml 语法poetry lock# 锁定依赖版本生成/更新 poetry.lockpoetry config--list# 查看配置需要安装插件的命令2.0 变化导出 requirements.txt# 先安装插件poetry selfaddpoetry-plugin-export# 然后使用poetryexport-frequirements.txt--outputrequirements.txt --without-hashes激活虚拟环境 shell# 先安装插件poetry selfaddpoetry-plugin-shell# 然后使用poetry shell常用工作流示例# 1. 克隆项目后gitclone projectcdproject poetryenvuse python3.10# 指定 Python 版本poetryinstall--withdev# 安装所有依赖包括开发依赖# 2. 日常开发poetryaddrequests# 添加新依赖poetry run pytest# 运行测试poetry run python main.py# 运行项目# 3. 更新依赖poetry update# 更新所有依赖到最新兼容版本poetry update requests# 只更新特定包# 4. 清理环境poetryenvlist# 查看环境poetryenvremove old-env# 删除旧环境2.0 最重要的新命令syncpoetry sync比poetry install更严格它会安装poetry.lock中记录的包移除任何不在poetry.lock中的包包括之前残留的poetrysync# 完美同步 lock 文件poetrysync--withoutdev# 排除 dev 组推荐日常开发用poetry installCI/CD 或需要干净环境时用poetry sync。