在服务器内网、无网络办公环境等场景下，常规的 curl | sh 或 pip install 安装方式完全失效。UV 作为 Rust 编写的高性能 Python 包管理器，其离线安装过程其实远比想象中简单。本文将带大家一步到位完成 UV 离线部署，同时补充离线安装 Python 包的实用技巧，适合所有技术层次的开发者。
一、为什么选择 UV 离线安装？
在无网环境中，UV 的优势尤为突出：
- 体积小巧：离线安装包仅几 MB，远小于 Python 官方包管理器的依赖集合；
- 跨平台兼容：Windows/macOS/Linux 全系统支持，安装逻辑统一；
- 功能强大：离线安装后可直接用于本地 Python 包管理、虚拟环境创建，无需额外依赖；
- 部署高效：全程无需复杂编译，解压+简单配置即可使用，小白也能快速上手。
二、前期准备：获取 UV 离线安装包（需联网电脑）
离线安装的核心是提前获取对应系统的 UV 二进制安装包，步骤如下：
- 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
小贴士：无需下载 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 系统快速配置
（2）macOS/Linux 系统快速配置
cd ~/Desktop/uv-x86_64-unknown-linux-gnu
说明：/usr/local/bin 是系统默认的可执行文件目录，全局均可访问，无需额外配置环境变量。
3. 验证安装成功
打开新的终端/命令行，输入以下命令：
uv –version
若输出类似 uv 0.41.0 (a1b2c3d4) x86_64-unknown-linux-gnu 的版本信息，说明离线安装成功！
四、拓展：离线使用 UV 安装 Python 包
安装 UV 后，若需在无网环境中给 Python 安装第三方包（如 requests、pandas），可按以下步骤操作：
uv pip download requests -d ./wheels
uv pip install –no-index –find-links=/path/to/wheels requests
- –no-index：不访问 PyPI 索引，仅从本地查找；
- –find-links：指定本地离线包所在目录。
五、常见问题排查
- Windows：检查环境变量 Path 中是否正确添加了解压目录，且已重启终端；
- macOS/Linux：确认 uv 已复制到 /usr/local/bin，可执行 ls /usr/local/bin/uv 验证是否存在。
- 重新下载对应系统的 tar.gz 包（不要下载源码包或其他架构的包），确保下载过程未中断。
- 联网下载时需使用 uv pip download（而非直接下载单个 .whl），该命令会自动下载包的所有依赖，确保离线安装无缺失。
六、总结
UV 的离线安装核心是「下载二进制包 → 解压 → 全局配置」，全程无需编译、无需联网，3 步即可完成部署，适合所有无网或内网环境。其不仅安装简单，还能高效管理本地 Python 包和虚拟环境，是无网场景下 Python 开发的理想工具。
如果觉得本文有用，欢迎点赞、收藏，也可以在评论区分享你的离线部署经验～
