一、安装 uv

# macOS / Linux
curl -LsSf  | sh

# Windows
powershell -ExecutionPolicy ByPass -c "irm  | iex"

# 通过 pip 安装（如果你更习惯）
pip install uv

# 通过 Homebrew 安装
brew install uv

验证安装：

uv --version

二、包管理（对标 pip）

安装包

uv pip install requests

安装指定版本

uv pip install requests==2.31.0

批量安装依赖

uv pip install -r requirements.txt

卸载包

uv pip uninstall requests

查看已安装的包

uv pip list

查看包详情

uv pip show requests

导出依赖

uv pip freeze > requirements.txt

升级包

uv pip install --upgrade requests

三、虚拟环境管理（对标 python -m venv）

创建虚拟环境

uv venv

指定目录 / Python 版本

uv venv myenv --python 3.12

激活虚拟环境

# macOS / Linux
source .venv/bin/activate

# Windows
.venvScriptsactivate

四、项目管理（uv 独有，对标 pip + venv + pip-tools 组合）

初始化项目

uv init myproject
cd myproject

添加依赖

uv add requests
uv add "flask>=3.0"

移除依赖

uv remove requests

同步依赖（按锁文件安装）

uv sync

运行脚本

uv run python main.py
uv run flask run

五、Python 版本管理（对标 pyenv）

安装 Python

uv python install 3.12

查看可用版本

uv python list

固定项目 Python 版本

uv python pin 3.12

六、一次性运行工具（对标 pipx）

uv tool run ruff check .
# 或简写
uvx ruff check .

全局安装工具

uv tool install ruff

七、常用技巧速查

八、项目文件结构说明

使用 uv init 后，项目中会出现以下关键文件：