跳到主要内容

Poetry 安装方式的几种方式

· 阅读需 2 分钟
素明诚
素明诚
Full stack development

官方推荐的安装脚本（推荐哦~）​

# Linux/macOS
curl -sSL https://install.python-poetry.org | python3 -
​
# Windows PowerShell
(Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing).Content | py -

特点​

  • 安装最新版本
  • 用户级安装，不需要 sudo
  • 安装后需要添加到 PATH

安装后的配置，添加到 PATH

# Linux/macOS - 添加到 ~/.bashrc 或 ~/.zshrc
export PATH="/home/$USER/.local/bin:$PATH"
​
# Windows
# 系统设置 > 环境变量 中添加 %APPDATA%\Python\Scripts
​
定期更新 Poetry 本身`poetry self update`

通过 pip 安装​

pip install --user poetry

特点​

  • 简单直接
  • 可能不是最新版本
  • 安装在用户目录下

通过包管理器安装​

# Ubuntu/Debian
sudo apt install python3-poetry
​
# macOS
brew install poetry

特点​

  • 系统级安装
  • 版本可能较旧
  • 自动添加到 PATH

验证安装​

# 检查是否安装成功
poetry --version
​
# 检查配置
poetry config --list

基本使用命令​

# 初始化新项目
poetry new my-project
​
# 在现有项目中初始化
poetry init
​
# 安装依赖
poetry install
​
# 添加新依赖
poetry add package-name
​
# 移除依赖
poetry remove package-name
​
# 更新依赖
poetry update

环境管理​

# 创建虚拟环境
poetry env use python3.10
​
# 查看虚拟环境信息
poetry env info
​
# 列出所有虚拟环境
poetry env list

常用配置​

# 设置虚拟环境在项目目录下
poetry config virtualenvs.in-project true
​
# 显示详细输出
poetry config --list
​
# 更改镜像源
poetry config repositories.foo https://foo.bar/simple/

注意事项​

  • 建议使用官方安装脚本，保证获取最新特性
  • 安装后记得添加到 PATH
  • 如果使用 conda，确保在正确的 conda 环境中使用 poetry
  • pyproject.toml 是核心配置文件，要仔细维护

卸载 Poetry​

# 使用官方脚本卸载
curl -sSL https://install.python-poetry.org | python3 - --uninstall
​
# 或直接删除安装目录
rm -rf ~/.local/share/pypoetry
rm -rf ~/.poetry

切换清华源​

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

增加 poetry 的超时时间，避免短时网络中断导致的传输错误。​

export PIP_DEFAULT_TIMEOUT=1000