Poetry 在 Linux 和 Windows 系统中的安装步骤

Poetry 在 Linux 和 Windows 系统中的安装步骤 ,区分默认安装和指定目录安装 ,并包括配置环境变量(如 POETRY_HOME、镜像源等)的说明。


✅ Poetry 安装指南

📌 一、Linux 系统(如 Ubuntu)


🔹 默认安装步骤

1. 安装 Poetry(默认路径)
bash 复制代码
curl -sSL https://install.python-poetry.org | python3 -
  • 默认安装路径为:~/.local/share/pypoetry/venv
  • 可执行文件路径为:~/.local/bin/poetry
2. 将 poetry 添加到 PATH
bash 复制代码
export PATH="$HOME/.local/bin:$PATH"
3. 验证安装
bash 复制代码
poetry --version
4. 永久生效(直接执行以下命令,写入 shell 配置)
bash 复制代码
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

🔹 指定目录安装步骤

1. 设置自定义安装目录(如 /opt/poetry)
bash 复制代码
export POETRY_HOME="/opt/poetry"

注意:你需要有写入 /opt/poetry 的权限,可以使用 sudo 或修改目录权限。

2. 安装 Poetry 到指定目录
bash 复制代码
curl -sSL https://install.python-poetry.org | python3 -
  • 安装路径变为:/opt/poetry/venv
  • 可执行文件路径为:/opt/poetry/bin/poetry
3. 将 poetry 添加到 PATH
bash 复制代码
export PATH="$POETRY_HOME/bin:$PATH"
4. 设置镜像源(可选)
bash 复制代码
export POETRY_PYPI_MIRROR="https://pypi.tuna.tsinghua.edu.cn/simple"
5. 永久生效(直接执行以下命令,写入 shell 配置)
bash 复制代码
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(默认路径)
powershell 复制代码
(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),运行:

cmd 复制代码
poetry --version

🔹 指定目录安装步骤

1. 手动设置 POETRY_HOME 环境变量
步骤如下:
  1. 右键点击"此电脑" → 属性 → 高级系统设置 → 环境变量。
  2. 在"用户变量"或"系统变量"区域中:
    • 点击"新建"
    • 变量名输入:POETRY_HOME
    • 变量值输入:D:\tools\poetry(或其他你希望的路径)
2. 安装 Poetry 到指定目录

在 PowerShell 中运行:

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. 验证安装是否成功

重启一个终端窗口,运行:

cmd 复制代码
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 修改系统环境变量 修改系统环境变量

相关推荐
StarsGreen5 小时前
Linux 网络配置命令参考
linux
飞奔的瓜牛14 小时前
Nginx 生产环境运维实践:常见问题、关注要点与日常维护
运维·nginx
Eyfcom17 小时前
〖物流 SaaS 实战 02〗SaaS 租户的计费与订阅模型:从“一锤子买卖”到“按需订阅”
linux·服务器·数据库·快递系统·物流saas实战
瑞克-桑切斯19 小时前
Kubernetes 1.28 保姆级新手学习教程
运维·学习·docker·云原生·容器·kubernetes
数据库急诊室_阿哲19 小时前
一次割接后的性能复核记录:基线、样本、回滚点
运维·数据库·dba
忆挽篱笙歌20 小时前
systemV进程通信
linux·运维·服务器
飞奔的瓜牛1 天前
Wireshark 抓包实战:呼叫中心项目中的 SIP、DTMF 与 RTP 分析
运维·wireshark
Funlang1 天前
在 Windows NT 3.5 上跑 Fun
windows
Decay__1 天前
SQLServer 监控体系构建 —— sql_exporter + Prometheus + Grafana 全栈实战
运维·数据库·sql·mysql·架构