【python】【UV】一篇文章学完新一代 Python 环境与包管理器使用指南

🐍 UV:新一代 Python 环境与包管理器使用指南


一、UV 是什么?

UV 是由 Astral 团队开发的高性能 Python 环境管理器,旨在统一替代 pyenvpipvenvpip-toolspipenv 等工具。

1.1 UV 的主要功能

  • 🚀 极速包安装(基于 Rust)
  • 🧠 自动管理虚拟环境
  • 🌀 Python 多版本支持与切换
  • 📦 统一依赖管理(支持锁文件)
  • 🌍 全局 pip 安装缓存共享
  • 💼 开发 / 生产环境依赖分离

二、UV 使用入门

2.1 下载与安装(https://docs.astral.sh/uv/getting-started/installation/#__tabbed_1_2)

💻 macOS / Linux
bash 复制代码
curl -LsSf https://astral.sh/uv/install.sh | sh
🪟 Windows(PowerShell)
powershell 复制代码
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
📦 Pip 安装(不推荐,功能不全)
bash 复制代码
pip install uv

安装完成后可用 uv --version 检查是否安装成功。


2.2 Python 版本管理

UV 支持下载并管理多个 Python 版本,类似于 pyenv

查看已安装的版本列表
bash 复制代码
uv python list
下载 Python 指定版本
bash 复制代码
uv python install 3.10
切换当前使用版本(pin)
bash 复制代码
uv python pin 3.10 #Pinned `.python-version` to `3.10`

✅ 切换后可立即使用对应版本的 Python 和环境进行项目初始化等操作。


2.3 初始化项目

建议先使用 uv python use 选择好目标版本,然后再进行项目初始化。

创建新项目(使用当前选中的 Python 版本)
bash 复制代码
uv init my-project
cd my-project
或直接指定 Python 版本
bash 复制代码
uv init -p 3.11 awesome-project

初始化会自动生成:

  • .venv/ 目录(项目虚拟环境)
  • pyproject.toml(项目依赖声明)
  • uv.lock(锁文件,锁定精确依赖)

三、UV Init 创建项目的注意事项

3.1 推荐使用 uv add 管理依赖

bash 复制代码
uv add requests
uv add flask sqlalchemy

UV 不建议使用 pip install 安装依赖,因为 UV 项目已默认隔离虚拟环境且依赖受锁文件保护。

3.2 UV 项目的"无 pip 安装"

UV 采用 全局 pip 缓存机制

  • 多个项目使用相同 Python 版本时,共享 pip 缓存,提高安装效率
  • 项目内并没有传统意义上的 pip install 机制
  • 因为 Python 版本一致 => pip 版本一致,避免 pip 被污染或冲突
  • uv.lock 文件用于保证项目依赖一致性,可类比 npm 的 package-lock.json

四、使用 UV 创建虚拟环境

初始化项目后,UV 自动为项目创建 .venv 虚拟环境,无需再手动 python -m venv

如需手动创建虚拟环境:

bash 复制代码
#运行:
uv venv 
#输出:
#Using CPython 3.13.3
#Creating virtual environment at: .venv
#Activate with: .venv\Scripts\activate

激活方式与常规 .venv 一致:

bash 复制代码
# Windows cmd运行venv环境
.venv\Scripts\activate
#退出venv环境
deactivate

五、开发与生产环境管理

UV 区分了开发依赖与生产依赖:

5.1 添加开发依赖

bash 复制代码
uv add --dev black pytest isort

pyproject.toml 中会区分:

复制代码
  [dependency-groups]
  dev = [
      "black>=25.1.0",
      "isort>=6.0.1",
      "pytest>=8.3.5",
  ]

uv.lock

复制代码
[package.metadata.requires-dev]
dev = [
    { name = "black", specifier = ">=25.1.0" },
    { name = "isort", specifier = ">=6.0.1" },
    { name = "pytest", specifier = ">=8.3.5" },
]

5.2 锁定依赖、部署同步

生成锁文件(默认自动生成):

bash 复制代码
uv lock

部署时安装所有依赖:

bash 复制代码
uv pip sync

或仅安装生产依赖:

bash 复制代码
uv pip sync --production

✅ 总结

功能 UV 表现
Python 多版本管理 ✅ 支持 install/use/list
虚拟环境 ✅ 自动创建 .venv/
依赖管理 ✅ 使用 pyproject.toml + uv.lock
安装效率 🚀 Rust 实现,远快于 pip
跨平台 ✅ 支持 macOS / Linux / Windows
开发/生产区分 ✅ 支持 --dev--production

UV = Python 开发的 Cargo,推荐前端 / 全栈 / 数据等开发者优先试用!


🧪 推荐实践

bash 复制代码
uv python install 3.11
uv python pin 3.11
uv init -p 3.11 my-fastapi-app
cd my-fastapi-app
uv add fastapi uvicorn
uv add --dev black pytest
uv pip sync
相关推荐
铭....18 分钟前
word批量导出visio图
开发语言·c#·word
2501_9118285029 分钟前
Python训练营---Day40
python·深度学习·机器学习
寻星探路34 分钟前
JAVA与C语言之间的差异(一)
java·开发语言
代码的乐趣34 分钟前
支持selenium的chrome driver更新到136.0.7103.113
chrome·python·selenium
1001101_QIA1 小时前
【QT】理解QT机制之“元对象系统”
开发语言·c++·qt·算法
爱上语文1 小时前
MyBatisPlus(1):快速入门
java·开发语言·数据库·后端·mybatis
marsjin1 小时前
如何使用Python从MySQL数据库导出表结构到Word文档
数据库·python·mysql
一叶知秋秋1 小时前
python学习day33
python·深度学习·学习
心软且酷丶2 小时前
leetcode:479. 最大回文数乘积(python3解法,数学相关算法题)
python·算法·leetcode
2501_915373882 小时前
Java调用C++教程:JNI与JNA两种方式详解
java·开发语言·c++