【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
相关推荐
hongyanwin1 小时前
cmake qt 项目编译(win)
开发语言·qt
元亓亓亓2 小时前
Java后端开发day42--IO流(二)--字符集&字符流
java·开发语言
weixin_472339463 小时前
PyCharm 安装教程
ide·python·pycharm
JANYI20183 小时前
在c++中老是碰到string&,这是什么意思?
开发语言·c++
passionSnail4 小时前
《MATLAB实战训练营:从入门到工业级应用》趣味入门篇-用声音合成玩音乐:MATLAB电子琴制作(超级趣味实践版)
开发语言·matlab
星川皆无恙4 小时前
大数据产品销售数据分析:基于Python机器学习产品销售数据爬虫可视化分析预测系统设计与实现
大数据·运维·爬虫·python·机器学习·数据分析·系统架构
shenyan~4 小时前
关于Python:9. 深入理解Python运行机制
开发语言·python
天堂的恶魔9464 小时前
C++ - 仿 RabbitMQ 实现消息队列(1)(环境搭建)
开发语言·c++·rabbitmq
白熊1884 小时前
【计算机视觉】pyrealsense2:Intel RealSense 深度相机的 Python 接口实战指南
python·数码相机·计算机视觉
殇淋狱陌5 小时前
【Python】常用命令提示符
开发语言·python·虚拟环境