目录一、uv 是什么二、uv 的安装1. 通用安装方式推荐2. 包管理器安装可选3. 验证安装三、uv 核心使用场景1. 基础包安装/卸载2. 虚拟环境管理3. 项目依赖管理兼容 pyproject.toml4. 运行 Python 代码/脚本四、进阶用法总结一、uv 是什么uv是由 Astral 公司开发的 Rust 编写的 Python 工具链核心优势是极速比 pip 快 10-100 倍、功能全面集成了包安装、虚拟环境管理、依赖解析、项目构建等能力兼容 pip/pipenv/poetry 的生态。uv 官方文档最核心地址https://docs.astral.sh/uv/这是uv最权威的使用指南包含安装、基础用法、进阶功能、API 参考等所有内容也是排查问题的首选。uv GitHub 源码仓库地址https://github.com/astral-sh/uv可以查看源码、提交 Issue反馈问题、提 PR贡献代码也能在 Releases 页面下载指定版本的uv安装包查看更新日志。uv 快速入门教程地址 https://docs.astral.sh/uv/getting-started/官方专为新手设计的快速上手指南比完整文档更精简适合刚接触uv时快速掌握核心用法。二、uv 的安装1. 通用安装方式推荐适用于 macOS、Linux、WindowsPowerShell执行以下命令自动下载适配系统的版本# macOS/Linuxcurl-LsSfhttps://astral.sh/uv/install.sh|sh# Windows (PowerShell)powershell-cirm https://astral.sh/uv/install.ps1 | iex2. 包管理器安装可选Homebrew (macOS/Linux)brewinstalluvCargo (Rust 环境)cargoinstalluv--lockedpip 安装不推荐仅应急pipinstalluv3. 验证安装安装完成后重启终端执行以下命令验证uv--version# 输出示例uv 0.1.37 (a1b2c3d 2026-03-03)三、uv 核心使用场景1. 基础包安装/卸载uv兼容 pip 的大部分用法且默认使用虚拟环境无需手动激活核心命令如下功能uv 命令说明安装包uv pip install requests极速安装单个包安装指定版本uv pip install requests2.31.0安装特定版本从 requirements.txtuv pip install -r requirements.txt批量安装依赖速度远快于 pip升级包uv pip install --upgrade requests升级包到最新版本卸载包uv pip uninstall requests卸载包查看已安装包uv pip list列出当前环境的包导出依赖uv pip freeze requirements.txt导出已安装包到文件2. 虚拟环境管理uv内置虚拟环境功能比venv更简洁# 创建虚拟环境默认在 .venv 目录uv venv# 激活虚拟环境# macOS/Linuxsource.venv/bin/activate# Windows (Cmd).venv\Scripts\activate.bat# Windows (PowerShell).venv\Scripts\Activate.ps1# 删除虚拟环境rm-rf.venv# macOS/Linuxrmdir/s .venv# Windows3. 项目依赖管理兼容 pyproject.tomluv支持现代 Python 项目的pyproject.toml配置替代requirements.txt# 初始化项目生成 pyproject.tomluv init my_projectcdmy_project# 添加依赖自动写入 pyproject.tomluvaddrequests# 生产依赖uvadd--devpytest# 开发依赖# 安装项目所有依赖从 pyproject.tomluvinstall# 同步依赖移除未在 pyproject.toml 中声明的包uvsync4. 运行 Python 代码/脚本uv可直接运行代码自动使用当前虚拟环境# 运行脚本uv run script.py# 运行临时代码uv run-cprint(Hello, uv!)# 运行模块uv run-mhttp.server8000四、进阶用法加速 pip 兼容如果项目暂时不想切换到 uv 命令可通过 uv 加速 pipuv pipinstallrequests# 等同于 pip install但更快指定 Python 版本uv可自动下载指定版本的 Python需提前安装pyenv或uv内置的 Python 解析器uv pythoninstall3.11# 安装 Python 3.11uv run--python3.11script.py# 使用 3.11 运行脚本缓存管理uv有全局缓存清理缓存命令uv cache clean# 清理所有缓存总结uv是高性能的 Python 包/环境管理工具安装简单兼容 pip/venv 生态核心优势是速度快、功能集成度高。核心用法uv pip install安装包、uv venv虚拟环境、uv add管理项目依赖、uv run运行代码。推荐在新项目中使用uv initpyproject.toml替代传统的requirements.txt提升依赖管理规范性。