解决 uv: command not found！极速 Python 工具 uv 安装全攻略
📌 摘要
你是否在使用 uv venv --python 3.12 --seed 时遇到过 -bash: uv: command not found 的错误？别急，这不是你的操作问题，而是系统还没安装这个“神器”！本文带你全面了解 uv —— 由 Astral 团队打造的超高速 Python 包与项目管理工具，比 pip 快 10-100 倍！我们将一步步教你如何正确安装 uv，避开常见坑（比如下错安装脚本），并提供多种安装方式：pip、官方一键脚本、pipx 等。无论你是新手还是老手，看完这篇都能轻松上手 uv，开启 Python 开发新速度！
什么是 uv？为什么它这么火？
uv 是由 Astral（Ruff 的开发团队）推出的下一代 Python 包管理工具，用 Rust 编写，性能极强。它能替代以下工具的大部分功能：
pip（安装包）virtualenv/venv（创建虚拟环境）pip-tools（依赖管理）pipx（安装和运行 CLI 工具）poetry（项目管理）
一个典型的使用场景是创建虚拟环境：
uv venv --python 3.12 --seed 这条命令会：
- 使用 Python 3.12 创建
.venv虚拟环境 - 自动安装
pip、setuptools等基础包（--seed参数）
但如果你执行时报错：
-bash: uv: command not found 说明 uv 还没安装！
✅ 正确安装 uv 的 3 种方式
方式一：通过 pip 安装（最简单）
uv 已发布到 PyPI，可以直接用 pip 安装：
pip install uv 如果你的 pip 版本较旧，建议先升级：
python -m pip install --upgrade pip python -m pip install uv ✅ 优点：简单直接，适合已有 Python 环境的用户
❌ 缺点：安装的是 Python 包，非原生二进制，略慢于方式二
方式二：使用官方一键安装脚本（推荐！）
这是官方推荐的安装方式，下载的是预编译的 Rust 二进制文件，速度更快、更独立。
在 macOS/Linux 上运行：
curl -LsSf https://install.astral.sh/uv |sh⚠️ 注意：不要使用https://install.python-poetry.org，那是给 Poetry 用的，不是uv！
安装完成后，uv 会被放到 ~/.local/bin 目录下，你需要将其加入 PATH：
exportPATH="$HOME/.local/bin:$PATH"为了让环境变量永久生效，可以写入 shell 配置文件：
echo'export PATH="$HOME/.local/bin:$PATH"'>> ~/.bashrc source ~/.bashrc 方式三：使用 pipx 安装（推荐用于 CLI 工具）
pipx 是专门用来安装和运行 Python 命令行工具的，非常适合安装 uv：
pipx install uv 如果你还没安装 pipx，可以先用 pip 安装它：
python -m pip install pipx pipx ensurepath ✅ 优点：隔离性好，不会污染全局环境
🌟 推荐给追求整洁环境的开发者！
🔁 总结：安装步骤速查表
| 步骤 | 命令 |
|---|---|
| 1. 安装 uv（任选其一） | pip install uv 或 `curl -LsSf https://install.astral.sh/uv |
| 2. 添加 PATH（仅脚本安装需要） | export PATH="$HOME/.local/bin:$PATH" |
| 3. 验证安装 | uv --version |
| 4. 创建虚拟环境 | uv venv --python 3.12 .venv |
| 5. 激活环境 | source .venv/bin/activate |
🐍 额外提醒：确保 Python 3.12 已安装
uv venv --python 3.12 要求系统中已安装 Python 3.12。检查方法：
python3.12 --version 如果没有，Ubuntu/Debian 用户可以这样安装：
sudoapt update sudoaptinstall python3.12 python3.12-venv python3.12-dev CentOS/RHEL 用户可使用 pyenv 或从源码编译。
🚀 uv 的其他强大功能
除了创建虚拟环境，uv 还能：
- 极速安装包：
uv pip install requests（比pip快 10 倍+） - 运行脚本：
uv run script.py（自动管理依赖） - 管理工具：
uvx black .（类似pipx run） - 项目初始化：
uv init myproject - 依赖同步：
uv sync（类似poetry install）
更多功能可查看官方文档：https://docs.astral.sh/uv
💬 写在最后
亲爱的读者，感谢你耐心读完这篇 uv 安装指南！希望你现在已经成功装上了这个“Python 包管理界的黑马”。无论是日常开发还是大型项目，uv 都能为你带来丝滑般的体验。如果你在安装过程中遇到任何问题，欢迎在评论区留言，我会第一时间为你解答！
祝你 coding 快乐，效率翻倍！
#标签 #Python #uv #包管理
