在服务器内网、无网络办公环境等场景下,常规的 curl | sh 或 pip install 安装方式完全失效。UV 作为 Rust 编写的高性能 Python 包管理器,其离线安装过程其实远比想象中简单。本文介绍如何完成 UV 离线部署,同时补充离线安装 Python 包的实用技巧,适合各类开发者参考。
一、为什么选择 UV 离线安装?
在无网环境中,UV 的优势尤为突出:
- 体积小巧:离线安装包仅几 MB,远小于 Python 官方包管理器的依赖集合;
- 跨平台兼容:Windows/macOS/Linux 全系统支持,安装逻辑统一;
- 功能强大:离线安装后可直接用于本地 Python 包管理、虚拟环境创建,无需额外依赖;
- 部署高效:全程无需复杂编译,解压 + 简单配置即可使用,小白也能快速上手。
二、前期准备:获取 UV 离线安装包(需联网电脑)
离线安装的核心是提前获取对应系统的 UV 二进制安装包,步骤如下:
- 访问 UV 官方 Releases 页面(无需登录,直接下载):https://github.com/astral-sh/uv/releases/latest
- 下拉找到「Assets」资源列表,根据目标电脑的系统和架构选择对应的离线包(优先选
tar.gz格式,解压即用):- Windows(64 位):
uv-x86_64-pc-windows-msvc.tar.gz - macOS(Intel 芯片):
uv-x86_64-apple-darwin.tar.gz - macOS(M1/M2/M3 芯片):
uv-aarch64-apple-darwin.tar.gz - Linux(64 位):
uv-x86_64-unknown-linux-gnu.tar.gz
- Windows(64 位):
- 下载完成后,通过 U 盘、移动硬盘或内网传输工具,将
.tar.gz压缩包拷贝到需要离线安装 UV 的目标电脑(建议放在桌面、/opt等易查找的目录)。
小贴士:无需下载 EXE 安装器或源码包,
tar.gz格式的二进制包已包含所有运行依赖,解压即可使用。
三、离线安装步骤(目标电脑操作,全程无网)
1. 解压离线安装包
不同系统的解压方式简单直观,无需复杂工具:
- Windows 系统:右键点击压缩包 → 选择「解压到当前文件夹」,解压后会生成一个包含
uv.exe的文件夹(如uv-x86_64-pc-windows-msvc); - macOS/Linux 系统:
- 图形化操作:右键压缩包 → 选择「解压」,自动生成对应文件夹;
终端操作:打开终端,切换到压缩包所在目录(如桌面),执行解压命令:
# 替换为实际下载的包名
tar -zxvf uv-x86_64-unknown-linux-gnu.tar.gz
解压完成后,核心可执行文件如下:
- Windows:
uv.exe - macOS/Linux:
uv(无后缀)
2. 配置全局访问(可选但推荐)
默认情况下,需在解压目录下调用 UV 程序。配置环境变量后,可在任意终端/命令行直接输入 uv 调用,步骤如下:
(1)Windows 系统快速配置
- 打开解压后的文件夹,复制文件夹的完整路径(如
C:\Users\张三\Desktop\uv-x86_64-pc-windows-msvc);

