Poetry 极速上手教程

📅 2026/7/3 6:14:21 👁️ 阅读次数 📝 编程学习
Poetry 极速上手教程

一、安装 Poetry

 
bash
 
运行
 
 
 
# Windows / Mac / Linux 通用
pip install poetry
 
 

二、核心常用命令(记住这几个就够用)

 

1. 新建项目

 
bash
 
运行
 
 
 
poetry new my_demo_project
 
 
自动生成标准工程结构pyproject.toml 配置文件。
 

2. 进入项目文件夹

 
bash
 
运行
 
 
 
cd my_demo_project
 
 

3. 创建虚拟环境 + 自动隔离依赖

 
bash
 
运行
 
 
 
poetry install
 
 
不用自己建 venv,Poetry 全自动帮你创建、管理虚拟环境。
 

4. 安装第三方包

 
bash
 
运行
 
 
 
poetry install requests
poetry install pandas
 
 
自动记录版本、锁定依赖,比 pip 规范太多
 

5. 运行项目(在虚拟环境里跑)

 
bash
 
运行
 
 
 
poetry run python main.py
 
 

6. 激活虚拟环境终端

 
bash
 
运行
 
 
 
poetry shell
 
 

7. 导出类似 requirements.txt(兼容旧部署)

 
bash
 
运行
 
 
 
poetry export -f requirements.txt --output requirements.txt
 
 

三、Poetry 比 pip+venv 强在哪

 
  1. 自带虚拟环境,不用手动创建
  2. pyproject.toml 管理依赖,替代简陋的 requirements.txt
  3. 自动版本锁定,团队拉下来环境完全一致
  4. 支持打包发布、依赖解析更智能,不会版本冲突
  5. 现代 Python 企业项目标配
 

四、项目结构长这样(标准工程)

 
plaintext
 
 
 
 
my_demo_project/
├── my_demo_project/
│   └── __init__.py
├── pyproject.toml   # 核心配置+依赖清单
└── README.rst