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

步骤如下：

1. 右键点击"此电脑" → 属性 → 高级系统设置 → 环境变量。

2. 在"用户变量"或"系统变量"中找到 Path，点击"编辑"。

3. 点击"新建"，输入以下路径（根据你的 Python 安装位置调整）：

   C:\Users<用户名>\AppData\Roaming\Python\Scripts

4. 确认保存所有更改。

3. 验证安装是否成功

重启一个终端窗口（CMD 或 PowerShell），运行：

poetry --version

---

🔹 指定目录安装步骤

1. 手动设置 POETRY_HOME 环境变量

步骤如下：

1. 右键点击"此电脑" → 属性 → 高级系统设置 → 环境变量。
2. 在"用户变量"或"系统变量"区域中：
   • 点击"新建"
   • 变量名输入：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

1. 回到"环境变量"窗口。

2. 编辑 Path，添加新项：

   D:\tools\poetry\bin

4. 手动设置 PyPI 镜像源（可选）

1. 回到"环境变量"窗口。
2. 新建一个变量：
   • 变量名：POETRY_PYPI_MIRROR
   • 变量值：https://pypi.tuna.tsinghua.edu.cn/simple

5. 验证安装是否成功

重启一个终端窗口，运行：

poetry --version

---

✅ 总结对比表

功能	Linux 默认安装	Linux 自定义目录安装	Windows 默认安装	Windows 自定义目录安装
安装命令	`curl ...	python3 -`	`curl ...	python3 -`
默认安装路径	~/.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	修改系统环境变量	修改系统环境变量

---