Poetry 完整安装与项目环境搭建指南

Poetry 完整安装与项目环境搭建指南

1. Poetry 安装方式

1.1 pip 安装（推荐新手使用）

# 使用 pip 安装
pip install poetry

# 验证安装
poetry --version

# 如果需要升级
pip install --upgrade poetry

1.2 官方安装脚本

# Windows PowerShell
(Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing).Content | py -

# Linux/MacOS
curl -sSL https://install.python-poetry.org | python3 -

1.3 环境变量配置

# Windows: 添加到用户环境变量
%APPDATA%\Python\Scripts

# Linux/MacOS: 添加到 PATH
export PATH="/home/<username>/.local/bin:$PATH"

2. Poetry 初始配置

2.1 基础配置

# 配置虚拟环境位置（推荐项目内）
poetry config virtualenvs.in-project true

# 配置镜像源（可选，国内用户推荐）
poetry config repositories.tsinghua https://pypi.tuna.tsinghua.edu.cn/simple

2.2 验证配置

# 查看所有配置
poetry config --list

# 测试是否正常工作
poetry new test-project

3. 创建新项目

3.1 项目初始化