哈哈哈

Appearance

UV 极速上手指南 ⚡ ​

🌟 Python 开发的新星

在这里你将掌握：

  • UV：下一代 Python 包管理工具 🚀
  • 极速依赖安装：告别漫长的等待 ⏱️
  • 跨平台支持：无论你在哪里都能飞 ✈️
  • 无缝迁移：从 pip/pipenv 轻松切换 🔄

1. 安装 UV：给你的 Python 装上涡轮增压 🏎️ ​

1.1 使用 pip 安装（传统方式） ​

bash
# 最新稳定版
pip install uv

# 或者预览版
pip install --pre uv

1.2 使用独立安装脚本（推荐） ​

bash
# Linux/macOS
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows PowerShell
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

1.3 验证安装 ​

bash
uv --version
# 应该看到类似：uv 0.1.0 (installed at /path/to/uv)

2. 快速开始：30 秒创建项目 🚀 ​

bash
# 创建新项目
uv init my-project
cd my-project

# 安装依赖（比 pip 快 10-100 倍！）
uv add requests pandas numpy

# 或者从 requirements.txt 安装
uv pip install -r requirements.txt

# 运行你的代码
uv run main.py

3. 依赖管理全家福 📦 ​

3.1 添加依赖（uv add） ​

bash
# 添加生产依赖
uv add flask sqlalchemy

# 添加开发依赖
uv add --dev pytest black

# 指定版本
uv add "django>=4.0,<5.0"

3.2 移除依赖（uv remove） ​

bash
# 移除不需要的包
uv remove unused-package

# 移除开发依赖
uv remove --dev old-test-framework

3.3 更新依赖（uv update） ​

bash
# 更新所有依赖
uv update

# 更新特定包
uv update requests pandas

4. 虚拟环境管理 🌐 ​

bash
# 创建虚拟环境（uv 会自动管理，无需手动创建）
uv venv

# 激活虚拟环境
# Linux/macOS
source .venv/bin/activate
# Windows
.venv\Scripts\activate

# 在虚拟环境中安装包
uv add --venv some-package

# 退出虚拟环境
deactivate

5. 脚本配置：一键运行你的任务 🎯 ​

在 pyproject.toml 中添加脚本：

toml
[tool.uv.scripts]
start = "python main.py"
test = "pytest tests/"
lint = "black . && flake8"
dev = "uv run --watch main.py"

# 复杂脚本
deploy = [
    "uv run build.py",
    "uv run deploy.py --production"
]

运行脚本：

bash
uv run start
uv run test
uv run lint

6. 与现有项目迁移 🔄 ​

6.1 从 requirements.txt 迁移 ​

bash
# 自动转换 requirements.txt 到 pyproject.toml
uv import requirements.txt

# 或者手动安装
uv pip install -r requirements.txt

6.2 从 Pipfile 迁移 ​

bash
# 导出 Pipfile 到 requirements.txt
uv pip compile Pipfile --output requirements.txt

# 然后导入
uv import requirements.txt

7. 高级用法：解锁 UV 的全部潜力 🧠 ​

7.1 并行安装 ​

bash
# 使用所有 CPU 核心（默认就是并行的！）
uv add multiple-packages --parallel

7.2 依赖解析和锁定 ​

bash
# 生成锁文件
uv lock

# 根据锁文件安装（确保一致性）
uv install --locked

7.3 跨平台开发 ​

bash
# 指定平台特定依赖
uv add pywin32 --platform windows
uv add pyobjc --platform darwin

🚨 UV 避坑指南 ​

  1. 缓存清理：uv cache clean 清理下载缓存
  2. 网络问题：设置镜像源 UV_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple/
  3. 兼容性：UV 兼容 pip 的大部分命令和选项
  4. 故障排除：使用 -v 或 -vv 参数查看详细日志

🎁 性能优化技巧 ​

bash
# 预下载依赖（Docker 构建优化）
uv pip download -r requirements.txt --output-dir /tmp/wheels

# 离线安装
uv install --offline --find-links /tmp/wheels

# 仅安装当前平台需要的包
uv install --no-deps --platform current

📜 UV 使用顺口溜 ​

Python 包管理，UV 来帮忙
安装快如风，告别慢时光
添加删除更新，命令简单明了
虚拟环境脚本，开发效率高
迁移无压力，兼容性良好
现代开发选 UV，快乐编程没烦恼

生活比喻：
UV 就像是个专业的快递小哥 🚚，不仅送货快（安装快），还能记住你的喜好（缓存），
根据天气选择最佳路线（跨平台支持），而且还能帮你整理包裹（依赖管理）！

现在就开始你的 UV 极速之旅吧！ ⚡