Poetry 速查
共 23 条 Poetry 常用命令，涵盖项目与依赖、安装与运行、查看信息、打包与发布、配置与兼容。 支持搜索与分类筛选，点击即可复制。
项目与依赖
用 pyproject.toml 管理依赖与打包。
| 命令 | 说明 |
|---|---|
| 创建项目骨架 | |
| 在已有目录交互式初始化 | |
| 添加依赖（自动更新 lock） | |
| 添加开发依赖组 | |
| 移除依赖 |
安装与运行
基于 lock 的确定性安装。
| 命令 | 说明 |
|---|---|
| 按 pyproject + lock 安装全部依赖 | |
| 不安装当前项目本身 | |
| 在虚拟环境中运行命令 | |
| 进入项目虚拟环境 | |
| 查看 / 列出环境 |
查看信息
依赖树与配置。
| 命令 | 说明 |
|---|---|
| 列出依赖 / 依赖树 | |
| 查看可升级依赖 | |
| 生成/刷新锁文件 | |
| 查看配置 | |
| 校验 pyproject 与 lock 一致性 |
打包与发布
构建分发包。
| 命令 | 说明 |
|---|---|
| 生成 sdist 与 wheel | |
| 发布到 PyPI | |
| 发布到测试源 | |
| 按规则升级版本号 |
配置与兼容
环境与导出。
| 命令 | 说明 |
|---|---|
| 指定使用的解释器 | |
| 在项目内创建 .venv | |
| 导出 requirements（需 export 插件） | |
| 国内加速 |
使用说明
Poetry 速查：项目与依赖、安装与运行、查看信息、打包与发布、配置与兼容；支持搜索与分类筛选，点击即可复制。
- 按用途点分类：项目与依赖、安装与运行、查看信息、打包与发布、配置与兼容。
- 点「命令」列复制到终端。
- 用 poetry add 管理依赖（自动写 pyproject 与 lock），用 poetry run 执行命令。
- 部署/CI 用 poetry install，依赖以 poetry.lock 为准。
常见问题
- poetry.lock 要提交吗？
- 要。它锁定精确版本，保证团队与 CI 装到一致依赖；不要在 .gitignore 里排除它。
- 怎么和 pip 工作流兼容？
- 用 poetry export 导 requirements.txt（需 export 插件），或让 CI 直接 poetry install。
- 需要联网吗？
- 速查内容本地可用；安装与发布需联网。