Poetry 命令大全及更新指南

404 字
2 分钟
Poetry 命令大全及更新指南
2026-10-02
编程语言
Python
/
Poetry
/
工具

1. 项目初始化与管理#

命令描述
​poetry new [project-name]​创建一个新的 Poetry 项目
​poetry init​交互式创建或更新 pyproject.toml​文件
​poetry install​安装项目依赖（根据 pyproject.toml​和 poetry.lock​）
​poetry update​更新依赖到最新允许的版本并更新 poetry.lock​
​poetry add [package]​添加依赖包
​poetry add [package]@[version]​添加指定版本的依赖包
​poetry add [package] --dev​添加开发依赖包
​poetry remove [package]​移除依赖包
​poetry show​显示已安装的依赖包
​poetry show --tree​以树状结构显示依赖关系
​poetry check​检查 pyproject.toml​文件的有效性

2. 虚拟环境管理#

命令描述
​poetry env list​或 poetry env list --full-path​列出所有 Poetry 虚拟环境
​poetry env info​显示当前项目的虚拟环境信息
​poetry env use [python-path]​为项目指定 Python 解释器
​poetry env remove [env-name or path]​删除虚拟环境
​poetry shell​激活项目的虚拟环境（进入交互式 shell）
​poetry run [command]​在虚拟环境中运行命令，不激活 shell

3. 打包与发布#

命令描述
​poetry build​构建项目为可分发的包（生成 .tar.gz​和 .whl​文件）
​poetry publish​将包发布到 PyPI 或其他配置的仓库
​poetry publish --repository [repo-name]​发布到指定的仓库
​poetry config repositories.[repo-name] [repo-url]​配置私有仓库

4. 配置管理#

命令描述
​poetry config --list​列出所有配置
​poetry config [key] [value]​设置配置值（如 poetry config virtualenvs.create true​）
​poetry config --unset [key]​删除配置值
​poetry self update​更新 Poetry 自身

5. 锁定文件管理#

命令描述
​poetry lock​生成或更新 poetry.lock​文件（不安装依赖）
​poetry lock --no-update​仅根据 pyproject.toml​重新生成 poetry.lock​，不更新依赖版本

文章分享

如果这篇文章对你有帮助，欢迎分享给更多人！

Poetry 命令大全及更新指南
https://guoxin.wiki/posts/poetry-cheatsheet/
作者
Guoxin
发布于
2026-10-02
许可协议
CC BY-NC-SA 4.0
React 学习 Day1：基础语法与整体框架（含 JS 关键基础）
2026 年 9 月复盘：换赛道的第一个月
相关文章智能推荐
1
Linux screen 命令详解
运维与工具screen 的常用命令与快捷键速查：会话创建、分离恢复、窗口操作，SSH 断线也不怕任务中断。
2
Tmux 详解：终端复用利器
运维与工具Server / Session / Window / Pane 的层级结构，常用快捷键与会话管理技巧，适合远程服务器和长时间任务。
3
Rust 所有权与核心概念完整指南
编程语言从 &str 与 String 的区别讲起，系统梳理 Rust 的所有权、借用、生命周期以及常见编译错误的成因。
4
Windows 11 上封锁 Claude Code 出网：防火墙 + DNS + hosts 三层实战
运维与工具用防火墙规则、DNS 重定向和 hosts 三层手段封锁 Claude Code 的出网流量，并给出一套可验证、可回滚的完整脚本与自检流程。
5
React 学习 Day1：基础语法与整体框架（含 JS 关键基础）
前端建立对 React 的整体认识，并补齐编写 React 所必需的 JavaScript 语法基础：组件化、Props/State、JSX 与常用概念。
随机文章随机推荐
Profile Image of the Author
Guoxin
写代码，也写思考。
公告
博客初建，笔记陆续搬家中。所有文章均经脱敏检查后发布。
分类
标签
更多
最新动态
站点统计
文章
12
分类
6
标签
24
总字数
13,485
运行时长
0 天
最后活动
0 天前
站点信息
构建平台
Unknown CI
博客版本
Firefly v6.16.8
文章许可
CC BY-NC-SA 4.0
文章目录
1
1. 项目初始化与管理
2
2. 虚拟环境管理
3
3. 打包与发布
4
4. 配置管理
5
5. 锁定文件管理