uv 是由 Astral（Rust 团队）开发的新一代 Python 工具，集成了 Python 安装、虚拟环境、依赖管理、pip 替代品 等功能，速度远超传统的 pip + pyenv + virtualenv 组合。

为什么选择 UV？

相比传统方案：

官方宣传速度可达到：

• pip 的 10~100 倍
• 支持 Python 多版本管理
• 自动创建虚拟环境
• 兼容 requirements.txt
• 兼容 pyproject.toml

一、安装 UV

Linux / macOS：

curl -LsSf https://astral.sh/uv/install.sh | sh

安装完成后会看到类似：

installing to /home/user/.local/bin

uv
uvx

everything's installed!

添加到 PATH

如果提示：

To add $HOME/.local/bin to your PATH...

执行：

source $HOME/.local/bin/env

或者永久加入：

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

验证安装：

uv --version

#例如：
uv 0.11.32

二、安装 Python

查看可安装版本：

uv python list

安装 Python：

uv python install 3.12

#或者指定完整版本：
uv python install 3.12.13

安装完成后：

uv python list

例如：
cpython-3.12.13-linux-x86_64

与 pyenv 不同，大多数情况下 UV 会直接下载官方预编译 Python，无需本地编译，因此安装速度非常快。

三、创建虚拟环境（venv）

#进入项目：
cd my_project

#创建 Python 3.12 虚拟环境：
uv venv --python 3.12
#或者：
uv venv --python 3.12.13

四、激活虚拟环境

Linux：

source .venv/bin/activate

激活后终端会显示：(.venv)user@server:~/project$

查看 Python：

python --version

#例如：
Python 3.12.13

退出：

deactivate

五、安装 requirements.txt

#进入项目：
cd my_project

#激活虚拟环境：
source .venv/bin/activate

#安装依赖：
uv pip install -r requirements.txt

相比传统：pip install -r requirements.txt
速度会快很多。

六、导出 requirements.txt

安装新依赖：

uv pip install fastapi
uv pip install uvicorn

导出：

uv pip freeze > requirements.txt

效果与 pip 完全一致。

七、运行 Python 项目

激活虚拟环境后：

python main.py

例如：

python app.py

FastAPI：

uvicorn app:app --reload

Flask：

python run.py

Django：

python manage.py runserver

八、不激活虚拟环境直接运行

UV 可以自动使用项目虚拟环境：

uv run main.py

#或者：
uv run python main.py

无需执行：

source .venv/bin/activate

九、安装单个依赖

例如：

uv pip install requests


#安装多个：
uv pip install requests fastapi uvicorn

升级：

uv pip install --upgrade requests

卸载：

uv pip uninstall requests

十、常用命令速查

# 安装 UV
curl -LsSf https://astral.sh/uv/install.sh | sh

# 安装 Python
uv python install 3.12

### 查看 Python
uv python list

# 创建虚拟环境
uv venv --python 3.12

# 激活
source .venv/bin/activate

# 安装依赖
uv pip install -r requirements.txt

# 导出依赖
uv pip freeze > requirements.txt

# 安装单个包
uv pip install requests

一键完成配置

uv venv --python 3.12 && source .venv/bin/activate && uv pip install -r requirements.txt

或者写进~/.bashrc

uvinit() {
    local pyver="${1:-3.12}"
    uv venv --python "$pyver" &&
    source .venv/bin/activate &&
    uv pip install -r requirements.txt
}

以后进入项目目录，只需要：uvinit

总结

推荐的开发流程如下：

# 安装 UV
curl -LsSf https://astral.sh/uv/install.sh | sh

# 安装 Python
uv python install 3.12.13

# 创建项目
mkdir my_project
cd my_project

# 创建虚拟环境
uv venv --python 3.12.13

# 激活环境
source .venv/bin/activate

# 安装依赖
uv pip install -r requirements.txt

# 启动项目
python main.py

整个流程无需安装 pyenv、virtualenv 等工具，uv 即可完成 Python 安装、虚拟环境创建、依赖管理与项目运行，是目前推荐的现代 Python 开发方式。