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

Poetry 完整安装与项目环境搭建指南

article 2024/11/18 5:12:20

Poetry 完整安装与项目环境搭建指南

1. Poetry 安装方式

1.1 pip 安装（推荐新手使用）

# 使用 pip 安装
pip install poetry

# 验证安装
poetry --version

# 如果需要升级
pip install --upgrade poetry

1.2 官方安装脚本

# Windows PowerShell
(Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing).Content | py -

# Linux/MacOS
curl -sSL https://install.python-poetry.org | python3 -

1.3 环境变量配置

# Windows: 添加到用户环境变量
%APPDATA%\Python\Scripts

# Linux/MacOS: 添加到 PATH
export PATH="/home/<username>/.local/bin:$PATH"

2. Poetry 初始配置

2.1 基础配置

# 配置虚拟环境位置（推荐项目内）
poetry config virtualenvs.in-project true

# 配置镜像源（可选，国内用户推荐）
poetry config repositories.tsinghua https://pypi.tuna.tsinghua.edu.cn/simple

2.2 验证配置

# 查看所有配置
poetry config --list

# 测试是否正常工作
poetry new test-project

3. 创建新项目

3.1 项目初始化

# 方式1：创建新项目
poetry new my-project

# 方式2：在现有项目中初始化
cd existing-project
poetry init

3.2 项目结构示例

my-project/
├── pyproject.toml      # 项目配置文件
├── poetry.lock        # 依赖锁定文件
├── README.md
├── my_project/
│   └── __init__.py
└── tests/
    └── __init__.py

4. 依赖管理

4.1 安装依赖

# 安装项目依赖
poetry install

# 添加新依赖
poetry add requests pandas

# 添加开发依赖
poetry add --group dev pytest black

4.2 更新依赖

# 更新所有依赖
poetry update

# 更新特定包
poetry update requests

5. 虚拟环境管理

5.1 环境操作

# 创建并激活虚拟环境
poetry shell

# 在虚拟环境中运行命令
poetry run python script.py

# 查看虚拟环境信息
poetry env info

5.2 依赖导出

# 导出 requirements.txt
poetry export -f requirements.txt --output requirements.txt

# 包含开发依赖
poetry export -f requirements.txt --with dev --output requirements-dev.txt

6. 常见问题解决

6.1 安装问题

# pip 安装失败时
python -m pip install --user poetry

# 权限问题
sudo pip install poetry  # Linux/MacOS

6.2 环境问题

# 重置虚拟环境
poetry env remove python
poetry install --remove-untracked

# 清理缓存
poetry cache clear . --all

7. 最佳实践建议

  1. 安装选择

    • 新手推荐使用 pip 安装，更容易理解和管理
    • 高级用户可以使用官方脚本，获得更好的版本控制

  2. 环境管理

    • 始终在项目目录下创建虚拟环境
    • 使用 poetry.lock 锁定依赖版本

  3. 依赖管理

    • 合理使用依赖分组
    • 定期更新依赖检查安全问题
    • 导出 requirements.txt 用于兼容性场景

  4. 开发流程

    • 使用 poetry shell 进入开发环境
    • 善用 poetry run 执行临时命令

8. 总结

Poetry 的安装和使用非常灵活，可以根据个人需求选择合适的安装方式：

  • pip 安装适合新手，操作简单直观
  • 官方脚本安装更加完整和可控
  • 配合虚拟环境使用更加规范

无论选择哪种安装方式，Poetry 都能帮助我们更好地管理 Python 项目，提高开发效率和项目质量。建议新项目都尝试使用 Poetry 进行依赖管理，体验现代化的 Python 开发工具链。

1. Poetry 安装方式

1.1 pip 安装（推荐新手使用）

# 使用 pip 安装
pip install poetry

# 验证安装
poetry --version

# 如果需要升级
pip install --upgrade poetry

1.2 官方安装脚本

# Windows PowerShell
(Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing).Content | py -

# Linux/MacOS
curl -sSL https://install.python-poetry.org | python3 -

1.3 环境变量配置

# Windows: 添加到用户环境变量
%APPDATA%\Python\Scripts

# Linux/MacOS: 添加到 PATH
export PATH="/home/<username>/.local/bin:$PATH"

2. Poetry 初始配置

2.1 基础配置

# 配置虚拟环境位置（推荐项目内）
poetry config virtualenvs.in-project true

# 配置镜像源（可选，国内用户推荐）
poetry config repositories.tsinghua https://pypi.tuna.tsinghua.edu.cn/simple

2.2 验证配置

# 查看所有配置
poetry config --list

# 测试是否正常工作
poetry new test-project

3. 创建新项目

3.1 项目初始化

# 方式1：创建新项目
poetry new my-project

# 方式2：在现有项目中初始化
cd existing-project
poetry init

3.2 项目结构示例

my-project/
├── pyproject.toml      # 项目配置文件
├── poetry.lock        # 依赖锁定文件
├── README.md
├── my_project/
│   └── __init__.py
└── tests/
    └── __init__.py

4. 依赖管理

4.1 安装依赖

# 安装项目依赖
poetry install

# 添加新依赖
poetry add requests pandas

# 添加开发依赖
poetry add --group dev pytest black

4.2 更新依赖

# 更新所有依赖
poetry update

# 更新特定包
poetry update requests

5. 虚拟环境管理

5.1 环境操作

# 创建并激活虚拟环境
poetry shell

# 在虚拟环境中运行命令
poetry run python script.py

# 查看虚拟环境信息
poetry env info

5.2 依赖导出

# 导出 requirements.txt
poetry export -f requirements.txt --output requirements.txt

# 包含开发依赖
poetry export -f requirements.txt --with dev --output requirements-dev.txt

6. 常见问题解决

6.1 安装问题

# pip 安装失败时
python -m pip install --user poetry

# 权限问题
sudo pip install poetry  # Linux/MacOS

6.2 环境问题

# 重置虚拟环境
poetry env remove python
poetry install --remove-untracked

# 清理缓存
poetry cache clear . --all

7. 最佳实践建议

  1. 安装选择

    • 新手推荐使用 pip 安装，更容易理解和管理
    • 高级用户可以使用官方脚本，获得更好的版本控制

  2. 环境管理

    • 始终在项目目录下创建虚拟环境
    • 使用 poetry.lock 锁定依赖版本

  3. 依赖管理

    • 合理使用依赖分组
    • 定期更新依赖检查安全问题
    • 导出 requirements.txt 用于兼容性场景

  4. 开发流程

    • 使用 poetry shell 进入开发环境
    • 善用 poetry run 执行临时命令

8. 总结

Poetry 的安装和使用非常灵活，可以根据个人需求选择合适的安装方式：

  • pip 安装适合新手，操作简单直观
  • 官方脚本安装更加完整和可控
  • 配合虚拟环境使用更加规范

无论选择哪种安装方式，Poetry 都能帮助我们更好地管理 Python 项目，提高开发效率和项目质量。建议新项目都尝试使用 Poetry 进行依赖管理，体验现代化的 Python 开发工具链。


http://www.kler.cn/a/398247.html

相关文章：

  • C++学习-空指针推荐使用nullptr
  • mybatis-plus: mapper-locations: “classpath*:/mapper/**/*.xml“配置！！！解释
  • 【CANOE】【学习】【DecodeString】字节转为中文字符输出
  • ADS学习笔记 5. 微带天线设计
  • Python教程笔记(2)
  • 15分钟学 Go 第 56 天：架构设计基本原则
  • 4-way 4-sets 缓存初始化
  • 基于云计算的分布式文件存储系统设计与实现
  • BERT的中文问答系统33
  • 简化编码流程提升开发效率：本地部署Code Llama与远程使用实战指南
  • 【jvm】为什么要用元空间替代永久代
  • LabVIEW前面板最大化显示与像素偏差分析 有源程序附件
  • Linux常用命令，持续更新钟
  • AIGC ---探索AI生成内容的未来市场
  • react 中 useRef Hook 作用
  • 机器学习—学习曲线
  • Vanna使用ollama分析本地MySQL数据库 加入redis保存训练记录
  • torch.stack 张量维度的变化
  • 记录大学Linux运维上机考试题目和流程
  • 使用Python实现对接Hadoop集群（通过Hive）并提供API接口
  • STM32F103移植FreeRTOS
  • Scala-字符串（拼接、printf格式化输出等）-用法详解
  • Spring Boot编程训练系统：开发与部署
  • SpringBoot 创建对象常见的几种方式
  • UEFI学习（五）——启动框架
  • web-02