在 Windows 上安装和配置 Poetry

在 Windows 上安装和配置 Poetry

1. 安装 Poetry

1.1 通过 PowerShell 安装

在 Windows 上，你可以使用 PowerShell 运行以下命令来安装 Poetry：

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

如果 python 命令未被识别，可以尝试 python3 或 py 代替。

1.2 通过 CMD 安装

如果你使用的是 CMD，可以运行以下命令：

powershell "(Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing).Content | py -"

1.3 验证安装

安装完成后，新起窗口可以运行以下命令检查 Poetry 是否安装成功：

poetry --version

如果能够正确输出 Poetry 的版本号，则说明安装成功。

---

2. 配置环境变量（可选）

安装完成后，如果 poetry 命令无法在终端中识别，可以手动添加 Poetry 的安装路径到系统环境变量。

1. 获取 Poetry 安装路径：
   通常，路径为：

   C:\Users\你的用户名\AppData\Roaming\Python\scripts
   

2. 添加到环境变量：

   • 右键“此电脑” → “属性” → “高级系统设置” → “环境变量”
   • 在“系统变量”或“用户变量”下找到 Path
   • 点击“编辑”，然后“新建” Poetry 目录的路径
   • 保存后重启终端，使更改生效

3. 验证环境变量：
   重新打开 CMD 或 PowerShell，运行：

   poetry --version
   

   如果仍然无法识别 Poetry，尝试重启计算机。

---

3. 配置默认下载源

Poetry 默认使用官方 PyPI 源下载包，但我们可以更改为国内或企业私有源，例如小米源。

3.1 设置默认 PyPI 源

poetry config pypi-url https://pkgs.d.xiaomi.net/artifactory/api/pypi/pypi-virtual/simple

3.2 配置额外的私有源（可选）

poetry config pypi-url https://pypi.tuna.tsinghua.edu.cn/simple

如果私有源需要身份验证，还可以设置访问令牌：

3.3 查看当前配置

poetry config --list

---

4. Poetry 常用命令

4.1 创建项目

poetry new my_project   # 创建一个新项目
poetry init             # 在当前目录初始化 Poetry 项目

4.2 依赖管理

poetry add requests     # 安装 requests 依赖
poetry remove requests  # 移除 requests 依赖
poetry update           # 更新所有依赖

4.3 运行和管理环境

poetry install          # 安装所有依赖
poetry shell            # 进入虚拟环境
poetry run python app.py  # 在虚拟环境中运行 Python 脚本

4.4 发布和配置包

poetry build            # 构建项目
poetry publish          # 发布项目到 PyPI

---

5. 结语

Poetry 是一个强大的 Python 依赖管理工具，适用于现代化的 Python 开发流程。通过本教程，你已经学会了如何在 Windows 上安装 Poetry、配置环境变量、修改默认下载源，并掌握了基本的 Poetry 命令。希望这些内容能帮助你更高效地管理 Python 项目！