简介

在 2025 年，uv 已成为 Python 生态中最受瞩目的“全能型”管理工具。它由 Astral 团队（Ruff 的开发者）使用 Rust 编写，旨在通过极致的性能和统一的体验，取代原有的多个零散工具

核心优势

极致的速度

安装速度比 pip 快 10 到 100 倍。其优秀的缓存设计使得在多次环境部署中几乎能实现秒级安装。

多合一工具箱

一个工具即可替代以下所有工具的功能：

  1. pip / pip-tools / Poetry： 包安装与依赖锁定。
  2. pyenv： Python 解释器版本管理（无需预装 Python，uv 可以直接下载安装）。
  3. virtualenv： 虚拟环境创建与管理。
  4. pipx： 独立运行 Python 工具（使用 uvx 命令）。
  5. 现代项目管理： 使用 pyproject.toml 标准并支持生成 uv.lock 锁文件，确保跨平台的环境一致性。

安装方式

Window

powershell -Command "irm https://astral.sh/uv/install.ps1 | iex"

Linux

  • 官方推荐：用 curl 或 wget 运行安装脚本： 
    curl -lssf https://astral.sh/uv/install.sh | sh
    或 
    wget -qo - https://astral.sh/uv/install.sh | sh
    详情可参考官方文档。

常用命令整理

功能分类 命令 功能描述 示例
项目初始化 uv init [project_name] 创建新项目，生成 pyproject.toml uv init my_project
虚拟环境管理 uv venv 创建虚拟环境（默认 .venv） uv venv --python 3.12
source .venv/bin/activate 激活虚拟环境（Linux/macOS）
.venv\Scripts\activate 激活虚拟环境（Windows）
deactivate 退出虚拟环境
依赖管理 uv add [package] 安装单个包 uv add requests
uv add --dev [package] 安装开发依赖 uv add --dev pytest
uv remove [package] 移除包 uv remove requests
uv sync 同步环境（根据 pyproject.toml） uv sync
uv tree 查看依赖树 uv tree --depth 2
运行脚本 uv run [script] 执行脚本（自动激活环境） uv run main.py
工具管理 uv tool install [tool] 安装全局工具 uv tool install black
Python 版本管理 uv python install [version] 安装 Python 版本 uv python install 3.12
uv python pin [version] 固定项目 Python 版本 uv python pin 3.12
缓存管理 uv cache clean 清理全局缓存 uv cache clean
其他实用命令 uv lock 生成锁文件 uv lock
uv lock --upgrade-package 升级指定包 uv lock --upgrade-package loguru

国内镜像配置

配置文件路径

# 1. Linux/macOS 用户
# 路径：~/.config/uv/config.toml
# 创建方法：mkdir -p ~/.config/uv && touch ~/.config/uv/config.toml

# 2. Windows 用户
# 路径：C:\Users\你的用户名\AppData\Roaming\uv\config.toml
# 创建方法：在文件资源管理器中新建文件夹 uv，再创建文件 config.toml

config.toml内容

[[index]]
url = "https://pypi.tuna.tsinghua.edu.cn/simple"
default = true
# python # uv # 开发语言
Logo
AI Agent技术社区

Agent 垂直技术社区，欢迎活跃、内容共建。

更多推荐

告别扫描文档处理烦恼：ScanTailor Advanced的智能文档优化解决方案

ScanTailor Advanced是一款专业的扫描文档后期处理工具，专为解决老旧文档数字化中的各种问题而设计。通过智能内容识别、批量处理和多线程优化，它能将倾斜、模糊、杂乱的扫描文档转化为整洁的电子文件，显著提升文档数字化效率。## 文档数字化的常见痛点与解决方案### 页面歪斜校正：智能算法自动修正传统扫描文档经常出现页面歪斜问题，手动调整每页耗时耗力。ScanTailor Adv

avatar AI Agent技术社区

4大核心模块深度解析：如何实现无人机集群的智能协同与安全飞行

你是否曾困惑于如何让多架无人机在复杂环境中自主协同飞行而不发生碰撞？传统的无人机控制方案往往面临**实时避障困难**、**协同通信复杂**、**轨迹规划计算量大**等挑战。EGO-Planner-v2作为一个源自《Swarm of micro flying robots in the wild》论文的开源项目，通过创新的模块化架构，为无人机集群控制提供了系统性解决方案。## 概念解析：无人机集

avatar AI Agent技术社区

SeedVR2终极指南：如何用单步扩散模型实现专业级视频修复

还在为老旧视频的模糊画质而烦恼吗？面对抖动严重的监控录像或褪色的家庭影像，你是否曾希望有一种简单高效的修复方案？SeedVR2正是为解决这些痛点而生的一站式视频修复工具。作为字节跳动推出的先进视频修复模型，它能够在单步推理中实现专业级的视频质量提升，彻底改变了传统视频修复的工作流程。## 核心价值：为什么选择SeedVR2进行视频修复？**传统视频修复的三大瓶颈**：1. **计算成本高

avatar AI Agent技术社区