安装

安装方式一：迁移到 uv 原生管理（推荐）

如果已经用 uv init 初始化了项目（有 pyproject.toml），可以把 requirements.txt 中的依赖导入进来：

uv add -r requirements.txt

这会读取 requirements.txt，把所有依赖写入 pyproject.toml，并生成 uv.lock 锁定文件。
之后只需要：

uv sync

就能一键安装所有依赖，版本完全锁定，团队协作或部署时更可靠。

安装方式二：兼容 pip（不改动项目结构）

方式1：直接安装

uv pip install -r requirements.txt

方式2：虚拟环境下安装

# 创建虚拟环境 .venv
uv venv

# windows激活
.venv\Scripts\activate
# linux/mac激活
source .venv/bin/activate

# 读取requirements.txt安装
uv pip install -r requirements.txt

导出 requirements.txt

用 uv 导出 requirements.txt 有两种方式，看你当前项目是哪种管理模式：

方式一：从 uv 项目导出（推荐，有 `pyproject.toml` + `uv.lock`）

如果已经用 uv init 初始化了项目，直接从锁文件导出：

uv export --format requirements-txt --no-dev --output-file requirements.txt

解释：

--no-dev：排除开发依赖，只导出运行依赖
--output-file requirements.txt：直接写入文件，不用手动重定向

如果想包含 dev 依赖，去掉 --no-dev 即可。

方式二：从当前虚拟环境导出（兼容 pip 模式）

如果你没有用 pyproject.toml 管理，只是用 uv pip install 装包，可以像 pip 一样导出：

uv pip freeze > requirements.txt

这会把当前 .venv 中所有已安装的包及精确版本写入文件。

安装