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