Poetry 在 Linux 和 Windows 系统中的安装步骤
Poetry 在 Linux 和 Windows 系统中的安装步骤，区分默认安装和指定目录安装，并包括配置环境变量（如 POETRY_HOME、镜像源等）的说明。
✅ Poetry 安装指南
📌 一、Linux 系统（如 Ubuntu）
🔹 默认安装步骤
1. 安装 Poetry（默认路径）
curl -sSL https://install.python-poetry.org | python3 -
- 默认安装路径为：
~/.local/share/pypoetry/venv - 可执行文件路径为：
~/.local/bin/poetry
2. 将 poetry 添加到 PATH
export PATH="$HOME/.local/bin:$PATH"
3. 验证安装
poetry --version
4. 永久生效（直接执行以下命令，写入 shell 配置）
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
🔹 指定目录安装步骤
1. 设置自定义安装目录（如 /opt/poetry）
export POETRY_HOME="/opt/poetry"
注意：你需要有写入
/opt/poetry的权限，可以使用sudo或修改目录权限。
2. 安装 Poetry 到指定目录
curl -sSL https://install.python-poetry.org | python3 -
- 安装路径变为：
/opt/poetry/venv - 可执行文件路径为：
/opt/poetry/bin/poetry
3. 将 poetry 添加到 PATH
export PATH="$POETRY_HOME/bin:$PATH"
4. 设置镜像源（可选）
export POETRY_PYPI_MIRROR="https://pypi.tuna.tsinghua.edu.cn/simple"
5. 永久生效（直接执行以下命令，写入 shell 配置）
echo 'export POETRY_HOME="/opt/poetry"' >> ~/.bashrc
echo 'export PATH="$POETRY_HOME/bin:$PATH"' >> ~/.bashrc
echo 'export POETRY_PYPI_MIRROR="https://pypi.tuna.tsinghua.edu.cn/simple"' >> ~/.bashrc
source ~/.bashrc
📌 二、Windows 系统（手动配置环境变量）
🔹 默认安装步骤
1. 使用 PowerShell 安装 Poetry（默认路径）
(Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing).Content | python -
- 默认安装路径为：
%APPDATA%\Python\Scripts\poetry.exe
2. 手动将 poetry 添加到系统环境变量 PATH
步骤如下：
- 右键点击“此电脑” → 属性 → 高级系统设置 → 环境变量。
- 在“用户变量”或“系统变量”中找到
Path，点击“编辑”。 - 点击“新建”，输入以下路径（根据你的 Python 安装位置调整）：
C:\Users\<用户名>\AppData\Roaming\Python\Scripts
- 确认保存所有更改。
3. 验证安装是否成功
重启一个终端窗口（CMD 或 PowerShell），运行：
poetry --version
🔹 指定目录安装步骤
1. 手动设置 POETRY_HOME 环境变量
步骤如下：
- 右键点击“此电脑” → 属性 → 高级系统设置 → 环境变量。
- 在“用户变量”或“系统变量”区域中：
- 点击“新建”
- 变量名输入：
POETRY_HOME - 变量值输入：
D:\tools\poetry（或其他你希望的路径）
2. 安装 Poetry 到指定目录
在 PowerShell 中运行：
(Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing).Content | python -
- Poetry 会自动识别你设置的
POETRY_HOME并安装到该目录下的bin文件夹中：D:\tools\poetry\bin\poetry.exe
3. 将 poetry 添加到系统环境变量 PATH
- 回到“环境变量”窗口。
- 编辑
Path，添加新项：
D:\tools\poetry\bin
4. 手动设置 PyPI 镜像源（可选）
- 回到“环境变量”窗口。
- 新建一个变量：
- 变量名：
POETRY_PYPI_MIRROR - 变量值：
https://pypi.tuna.tsinghua.edu.cn/simple
- 变量名：
5. 验证安装是否成功
重启一个终端窗口，运行：
poetry --version
✅ 总结对比表
| 功能 | Linux 默认安装 | Linux 自定义目录安装 | Windows 默认安装 | Windows 自定义目录安装 |
|---|---|---|---|---|
| 安装命令 | curl ... | python3 - | curl ... | python3 - | PowerShell 命令 | PowerShell 命令 |
| 默认安装路径 | ~/.local/share/pypoetry/venv | /opt/poetry/venv | %APPDATA%\Python\Scripts\poetry.exe | %POETRY_HOME%\bin\poetry.exe |
| 添加到 PATH | export PATH=... | export PATH=... | 手动添加 Python\Scripts 到 Path | 手动添加 %POETRY_HOME%\bin 到 Path |
| 设置镜像源 | export POETRY_PYPI_MIRROR=... | export POETRY_PYPI_MIRROR=... | 手动设置系统变量 POETRY_PYPI_MIRROR | 手动设置系统变量 POETRY_PYPI_MIRROR |
| 永久生效 | 写入 .bashrc / .zshrc | 写入 .bashrc / .zshrc | 修改系统环境变量 | 修改系统环境变量 |