在现有python项目中接入uv工具，核心做法是使用 uv init 初始化项目结构并生成 pyproject.toml，随后通过 uv sync 同步依赖。这样做会自动创建虚拟环境并将所有包安装到其中，实现环境隔离。如果项目中已有 requirements.txt，可以直接使用 uv pip install -r requirements.txt 快速迁移依赖。
如何从旧版 requirements.txt 迁移到 uv 管理的 pyproject.toml
将现有的 requirements.txt 转换为 pyproject.toml 格式是迁移的第一步。可以使用 uv add 命令逐个添加依赖，或者直接使用 uv pip compile 进行转换。推荐使用 uv sync 来确保环境一致性。
import subprocess
import sys
# 模拟从 requirements.txt 读取依赖
def migrate_requirements(req_file):
try:
with open(req_file, 'r') as f:
deps = [line.strip() for line in f if line.strip() and not line.startswith('#')]
# 使用 uv pip install 安装依赖到当前环境（或虚拟环境）
# 注意：这不会自动生成 pyproject.toml，但会安装依赖
subprocess.check_call([sys.executable, '-m', 'pip', 'install'] + deps)
print(f"已安装 {len(deps)} 个依赖")
except FileNotFoundError:
print(f"文件 {req_file} 不存在")
except Exception as e:
print(f"安装失败: {e}")
if __name__ == '__main__':
migrate_requirements('requirements.txt')
预期结果：终端输出“已安装 X 个依赖”，且所有依赖包被安装到当前 Python 环境中。此方法仅安装依赖，不生成 pyproject.toml，需手动创建或使用 uv init 重新生成。
如何使用 uv 管理现有项目的虚拟环境
对于已经存在的代码库，使用 uv venv 创建虚拟环境是最直接的方式。创建后，通过 uv sync 或 uv pip install 安装依赖。这种方式保留了原有的项目结构，同时引入了 uv 的环境管理能力。
# 假设项目根目录下有 main.py 和 requirements.txt # 1. 创建虚拟环境 # $ uv venv .venv # 2. 激活虚拟环境 (Linux/macOS) # $ source .venv/bin/activate # 3. 安装依赖 # $ uv pip install -r requirements.txt # 4. 运行项目 # $ python main.py
预期结果：在项目根目录生成 .venv 文件夹，内部包含独立的 Python 解释器和 site-packages。运行 python main.py 时，使用的是虚拟环境中的解释器，且所有依赖已就绪。
当 pyproject.toml 中指定了特定 Python 版本时 uv 如何处理
当 pyproject.toml 中通过 requires-python 指定了版本范围（如 =3.9），uv sync 会检查当前系统 Python 版本是否符合要求。如果不符合，uv 会自动下载并管理对应版本的 Python 解释器，无需用户手动安装。这一特性确保了开发环境的一致性。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
