【python虚拟环境管理】【mac m3】使用poetry管理python项目

Poetry是Python中用于依赖管理和打包的工具。它允许您声明项目所依赖的库，并将为您管理（安装/更新）它们。Poetry提供了一个锁定文件，以确保可重复安装，并可以构建用于分发的项目。

一. 为什么选择poetry

在项目规模扩大时，依赖关系管理变得更为复杂，此时为什么Poetry 这样的工具变得必要：

1. 增加的依赖关系数量： 随着项目规模的增大，项目通常会引入更多的依赖关系。不同的依赖可能需要特定版本，而这可能导致依赖冲突。

2. 环境难以重现： 当项目的依赖关系数量增加时，使用传统的依赖管理工具（如 pip 或 Conda）可能会导致环境难以重现。这意味着在不同的开发环境或部署环境中，依赖的版本和配置可能会有所不同，从而增加了出现问题的可能性。

3. 维护困难： 仅仅依靠 pip 或 Conda 进行依赖管理，可能需要手动维护 requirements.txt 或 environment.yml 等文件。这种方式可能导致配置文件的冗长和复杂性，增加了维护项目一致性的难度。

4. Poetry 的优势：

   • Poetry 提供了一个新的方法来管理 Python 项目的依赖关系和环境。它通过统一的 pyproject.toml 文件来管理项目的依赖，提供了更简洁、更清晰的方式定义项目的依赖关系和版本约束。
   • Poetry 还支持锁定依赖版本，确保在不同的环境中都可以重现相同的依赖关系，从而增强了项目的可重现性和一致性。
   • Poetry 还包括便捷的虚拟环境管理功能，可以帮助隔离项目环境，避免与系统或其他项目的依赖冲突。
   • 此外，Poetry 支持项目的打包和发布，使得分发 Python 应用程序变得更加简单和一致。

 

二. poetry相关操作

1. 创建并激活环境

1. 创建新的 Poetry 项目

# my-project 虚拟环境名称
#这个命令会创建一个名为 `my-project` 的新目录，并在其中生成一个基本的 Poetry 项目结构。  
# 可以使用 --path 或 -p 选项来指定一个特定的目录。
poetry new my-project

2. 项目初始化

# 如果是已有项目转为使用poetry作为依赖管理，可以进行初始化
poetry init

3. 激活虚拟环境

# 在项目创建后，通过如下命令来激活环境
# 这个命令会安装 `pyproject.toml` 中定义的所有依赖项，并激活虚拟环境。poetry install

4. 查看当前环境信息

poetry env info

 

2. 依赖包管理

2.1. 安装项目依赖

# 安装pyproject.toml文件中的全部依赖poetry install# 安装最新稳定版本的flask
poetry add numpy# 指定具体的版本
poetry add flask=2.22.0 

当然也可以使用pip来安装依赖，只要注意pip安装在此虚拟环境下。

 

1.2. 管理不同开发环境的依赖

通过添加配置参数–dev来区分不同环境下的依赖包。

# 指定为开发依赖，会写到pyproject.toml中的[tool.poetry.dev-dependencies]区域
poetry add pytest --dev # 只安装非development环境的依赖，一般部署时使用
poetry install --no-dev  

 

1.3. 依赖维护

# 更新所有锁定版本的依赖包
poetry update#更新指定依赖包
poetry update numpy# 卸载依赖包
poetry remove numpy

 

1.4. 项目相关

# 查看项目安装的依赖
poetry show# 查看可以更新的依赖
poetry show --outdated# 树形结构查看项目安装的依赖
poetry show -t

 

参考：
https://blog.csdn.net/qq_40851623/article/details/135769991