uv 常用命令

创建新项目

可以使用 uv init 命令创建一个新的 Python 项目：

uv init hello-world
cd hello-world

或者，也可以在当前工作目录中初始化一个项目：

mkdir hello-world
cd hello-world
uv init

uv 将创建以下文件：

.
├── .python-version
├── README.md
├── main.py
└── pyproject.toml

创建虚拟环境

uv 支持创建虚拟环境，例如，在刚刚创建的 hello-world 项目中的.venv目录下创建一个虚拟环境（默认创建.venv目录）：

uv venv

使用虚拟环境

可以 “激活” 虚拟环境，以便使用其中的包：

macOS 和 Linux：

source .venv/bin/activate

Windows：

.venv\Scripts\activate

停用环境

要退出虚拟环境，请使用 deactivate 命令：

deactivate

安装依赖

可以使用 uv add 命令将依赖项添加到 pyproject.toml 中。这也会更新锁定文件和项目环境：

uv add requests

如果之前用 uv pip install 安装了依赖，可以手动迁移到 pyproject.toml：

# 1. 生成当前环境的依赖列表
uv pip freeze > requirements.txt

# 2. 用 uv 重新安装并同步
uv add -r requirements.txt

要移除一个包，可以使用 uv remove：

uv remove requests