uv 离线安装包
它是什么uv 是 Astral 团队用 Rust 编写的 Python 包与项目管理器,替代 pip 与 virtualenv 组合。
uv 是 Astral 团队用 Rust 编写的 Python 包与项目管理器,替代 pip 与 virtualenv 组合。其离线部署核心是「下载二进制包 → 解压 → 全局配置」,三步完成、无需编译也无需联网,适合内网与无网环境部署并管理本地 Python 包和虚拟环境。
详细介绍
简介
uv 是由 Astral 团队(Ruff 的创建者)用 Rust 编写的 Python 包与项目管理器,用来替代 pip 与 virtualenv 的组合,把包管理、虚拟环境管理和项目配置整合进同一个工具。它要解决的问题很直接:内网、机房和隔离网络里的 Python 环境访问不了公网,常规命令拉取依赖会失败。面向这类场景,uv 的离线部署核心是「下载二进制包 → 解压 → 全局配置」,全程无需编译、无需联网,三步即可完成,之后就能管理本地 Python 包和虚拟环境,速度快、环境干净。
核心功能
- 包管理对标 pip:uv pip install 把包装进当前环境,uv pip show 显示已安装包的详细信息,uv pip freeze 列出已安装包及其版本。
- 虚拟环境管理:对标 python -m venv 的用法,负责创建与切换项目环境,替代 virtualenv。
- 依赖关系查看:管理项目依赖,可替代 pip 与 pipdeptree 的组合,用于梳理依赖树。
- 解释器与脚本:功能覆盖从安装 Python、编写简单脚本,到支持多个 Python 版本和平台的大型项目,各部分既可独立使用也可组合使用。
- 预构建分发包:为许多平台提供预构建的 wheel;若某个平台没有可用的 wheel,则从源码构建,这需要 Rust 工具链。
- 多渠道分发:GitHub Releases 的每个发布页面包含所有支持平台的二进制文件,以及通过 github.com(而非 astral.sh)使用独立安装程序的说明;另提供 Docker 镜像 ghcr.io/astral-sh/uv。
使用场景
- 内网或完全无网的服务器、容器中部署 Python 包管理器,全程不访问公网。
- 在一台能联网的机器上集中准备二进制包,再拷贝到隔离环境批量分发。
- 日常 Python 项目里用一套命令同时完成装包、建虚拟环境和查看依赖。
- 需要并行维护多个 Python 版本、覆盖多个平台的大型项目。
- 容器化交付:直接使用官方 Docker 镜像 ghcr.io/astral-sh/uv。
- 运行把 uv 列为前置依赖的应用时先补齐环境,例如某些应用的原版流程涉及 Git、uv、Python 3.11+ 及手动编辑配置文件。
安装与获取步骤
- 在能联网的机器上获取发布文件:GitHub Releases 的每个发布页面都包含所有支持平台的二进制文件,也可查看中文文档安装页 https://uv.doczh.com/getting-started/installation/ 与 https://hellowac.github.io/uv-zh-cn/getting-started/installation/。
- 按目标机器的操作系统与 CPU 架构挑选对应平台的二进制包并下载到本地。
- 把二进制包拷贝到无网机器后直接解压,这一步无需编译、无需联网。
- 完成全局配置,让 uv 在任意目录下都能被调用;具体配置方式以官方页面为准。
- 运行 uv --version 确认可执行文件能正常启动,随后用 uv pip install、uv pip freeze 等子命令管理包与虚拟环境。
- 若目标平台没有可用的 wheel,需从源码构建,此时要准备 Rust 工具链;容器场景可改为拉取镜像 ghcr.io/astral-sh/uv。
与同类方案的区别
- 对比 pip + virtualenv:uv 用一个工具覆盖装包与虚拟环境两件事,命令前缀统一为 uv pip。
- 对比在线 pip:在线方式依赖公网索引,离线路径只做二进制包的解压与全局配置,不触发网络。
- 对比 conda:素材中存在与 conda/pip 的对比文章,具体差异需结合项目实际判断,以官方页面为准。
- 速度取向:uv 由 Rust 编写,主打快、干净、易用,目标是让开发者更省心高效。
获取渠道与版本速查
- GitHub Releases:每个发布页面包含所有支持平台的二进制文件,以及通过 github.com 使用独立安装程序的说明。
- Docker 镜像:ghcr.io/astral-sh/uv。
- 中文文档:https://uv.doczh.com/getting-started/installation/ 、https://hellowac.github.io/uv-zh-cn/getting-started/installation/ ;功能概述见 https://uv.oaix.tech/getting-started/features/ 。
- 版本号、发布日期与文件校验值一律以官方页面为准,本页不作罗列。
注意事项
- 二进制包必须与目标机器的操作系统和 CPU 架构一致,选错平台的包解压后无法执行。
- 若某平台没有可用的 wheel,源码构建需要 Rust 工具链,离线机器通常不具备,应在有工具链的环境预先构建好。
- 解压后需完成全局配置,让 uv 出现在命令搜索路径中,否则在任意目录输入 uv 会提示找不到命令。
- Docker 镜像地址为 ghcr.io/astral-sh/uv,需在能访问该仓库的环境完成拉取后再转入内网。
- 升级路径取决于当初使用的是独立安装程序还是其他渠道,说明见对应发布页面,以官方页面为准。
更新记录
最近更新:2026-10-09
软件参数速览
参数对比
| 项目 | uv 离线安装包 |
|---|---|
| 版本 | 0.13.3 |
| 大小 | 14.8 MB |
| 平台 | win |
| 网盘 | 百度 |
历史版本
本站收录该软件的多个真实版本,可按下表选用:
| 版本 | 平台 | 大小 | 网盘 | 入口 | 官网 |
|---|---|---|---|---|---|
| 0.13.3 | win | 14.8 MB | 百度 | uv 离线安装包 0.13.3(查看/下载) | —— |
下载
下载由本站收录的国内网盘提供(夸克 / 百度 / 蓝奏),国内访问快、不限速;网盘链接均经审核,如失效欢迎反馈。
常见问题
内网机器上 pip 拉取依赖报网络超时,改走 uv 离线路径要准备什么?
准备与目标机器操作系统、CPU 架构一致的 uv 二进制包:在有网机器从 GitHub Releases 下载,拷贝过去后解压并完成全局配置,全程无需编译、无需联网。
解压后输入 uv 提示找不到命令,怎么处理?
说明全局配置没做完,可执行文件所在目录不在命令搜索路径里。把该目录加入 PATH 或改用完整路径调用,再运行 uv --version 验证能否正常启动。
uv 和 pip、virtualenv 是什么关系?
uv 由 Rust 编写,目标是替代 pip 与 virtualenv 的组合:uv pip install 对标 pip 装包,uv pip show、uv pip freeze 对应查看已安装包,建环境对标 python -m venv。
某个平台没有可用的 wheel 会怎样?
uv 会改为从源码构建,这需要 Rust 工具链。离线机器一般没有该工具链,建议在具备工具链的环境预先构建完成后再带入隔离环境。
完全无网的机器能直接跑官方独立安装程序吗?
独立安装程序的说明在 GitHub Releases 发布页面(通过 github.com 而非 astral.sh),其运行需要网络。无网环境更适合走「下载二进制包 → 解压 → 全局配置」的离线路径。
uv 可以用 Docker 方式部署吗?
可以,uv 提供 Docker 镜像,地址为 ghcr.io/astral-sh/uv。需要在能访问该仓库的环境完成拉取,再按团队内网的镜像分发流程转入隔离环境。
uv 除了管包还能做什么?
功能覆盖从安装 Python、编写简单脚本,到支持多个 Python 版本和平台的大型项目,各部分既可独立使用也可组合使用,详见功能概述 https://uv.oaix.tech/getting-started/features/ 。
已经部署好的 uv 如何升级?
当 uv 通过独立安装程序管理时,升级说明见对应发布页面;独立安装程序、Docker 镜像、源码构建三种渠道的升级方式不同,具体以官方页面为准。