python uv最常用命令

下面是 uv 最常用、最实用的命令清单，按功能分类，记住这些基本就能完全用 uv 替代 pip、venv、pipx、pyenv、poetry。

---

🚀 uv 最常用命令大全

---

1️⃣ 包管理（替代 pip）

安装包

uv pip install package_name

卸载包

uv pip uninstall package_name

查看已安装包

uv pip list

安装 requirements.txt 依赖

uv pip install -r requirements.txt

---

2️⃣ 虚拟环境（替代 venv）

创建虚拟环境（推荐）

uv venv

默认生成 .venv/。

使用特定 Python 版本创建虚拟环境

uv venv --python 3.12

进入虚拟环境

macOS/Linux：

source .venv/bin/activate

Windows：

.venv\Scripts\activate

---

3️⃣ Python 版本管理（替代 pyenv）

查看可安装的 Python

uv python list --all

安装 Python 版本

uv python install 3.12

查看已安装的 Python

uv python list

锁定项目使用的 Python 版本

uv python pin 3.12

---

4️⃣ 项目依赖管理（替代 poetry/pip-tools）

初始化项目（创建 pyproject.toml）

uv init

安装 pyproject.toml 依赖并生成锁文件

uv sync

添加依赖

uv add requests

删除依赖

uv remove requests

---

5️⃣ 运行 Python / 工具（替代 pipx / npx）

运行 Python 文件

uv run app.py

运行 Python 模块

uv run -m http.server

运行工具（不用安装，类似 npx）

uvx ruff
uvx httpie
uvx black

---

6️⃣ 其他常用命令

查看 uv 版本

uv --version

更新 uv

uv self update

---

🎯 最简记忆版（超常用 TOP 10）

uv pip install xxx
uv pip uninstall xxx
uv pip list

uv venv
uv venv --python 3.12
uv python install 3.12

uv run script.py
uvx tool

uv init
uv sync