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 修改系统环境变量 修改系统环境变量

相关推荐
小白不想白a30 分钟前
【shell】每日shell练习:安全日志入侵检测/系统配置文件合规检查
运维·服务器
字节逆旅1 小时前
一个从从容容,一个连滚带爬:scp 与 rsync 的不同人生
linux
洛克大航海1 小时前
Linux 中新建用户
linux·运维·服务器
位步2 小时前
在linux系统中使用通用包安装 Mysql
android·linux·mysql
dehuisun2 小时前
jenkins流水线部署springboot项目
运维·jenkins
fly五行2 小时前
Windows 系统下使用 Docker 安装 Milvus 向量数据库
windows·docker·milvus
hello kitty w3 小时前
Python学习(11) ----- Python的泛型
windows·python·学习
蜜蜜不吃糖3 小时前
解决Vcenter告警datastore存储容量不足问题
linux·运维·服务器
zzz.103 小时前
top命令的详解
linux·服务器·网络
东城绝神3 小时前
《Linux运维总结:基于ARM64+X86_64架构CPU使用docker-compose一键离线部署redis 7.4.5容器版分片集群》
linux·运维·redis·架构·分片集群