当前位置：首页 > news >正文

poetry安装与使用

news 2025/7/4 23:33:05

安装方法

安装命令（全局安装，不要在虚拟环境中安装，方便后面创建环境使用）
```
pip3 install poetry
```
修改虚拟环境路径（首次使用poetry时执行，修改全局配置文件）
poetry默认虚拟环境创建在系统目录，这里我们修改配置，将默认虚拟环境创建在项目目录
```
poetry config virtualenvs.in-project true
```

包括两种：

进入项目跟目录，如果项目下有不是poetry创建的env目录，就先删了

初始化poetry，创建 pyproject.toml 文件（该文件用于记录虚拟环境的相关信息）
```
poetry init
```
一路回车就行（有个作者名称要输一下）
创建虚拟环境
```
poetry env use python3
```
生成poetry的env目录
pycharm配置poetry环境

如果从远端仓库上拉取的代码，需要从 pyproject.toml 中安装第三方依赖包
在这里插入图片描述

首先创建虚拟环境，参考本文上述 创建新虚拟环境【新环境使用】 中的第2步和第3步，但第1步不要执行，因为别人项目下已经有 pyproject.toml 了，不需要再生成了
执行命令安装 pyproject.toml 中的依赖
```
poetry install
```

查看虚拟环境下已安装的所有包
```
poetry show
```
安装第三方包
```
poetry add 包名
```
安装第三方包（仅在开发环境）
```
poetry add 包名 --group dev
```
卸载第三方包
```
poetry remove 包名
```
创建虚拟环境
```
poetry env use python3
```
删除虚拟环境
```
poetry env remove python3
```
查看poetry全局配置文件
```
poetry config --list
```
修改全局配置文件
```
poetry config 字段名 字段值 
```
进入虚拟环境
```
.\.venv\Scripts\activate
```
退出虚拟环境
```
deactivate
```
导出 requirements.txt 用于docker部署
```
poetry export -f requirements.txt -o requirements.txt --without-hashes
```
–without-hashes 去掉哈希加密字段，否则线上安装依赖时可能会报错

使用 poetry add 安装第三方包的时候，只要在项目根目录下执行命令，不用进到虚拟环境也可以把包安装到虚拟环境中
安装第三方包后会生成一个poetry.lock记录第三方包的依赖关系（这个文件不用管，是由poetry自行管理的依赖）
部署上线时不使用 poetry，一般不在 docker 中使用虚拟环境，而是将 poetry 虚拟环境中的包依赖导出到 requirements.txt，在 Dockerfile 中执行 RUN pip install -r requirements.txt