使用 uv 快速创建和管理 Python 虚拟环境（新手友好教程）

uv 是目前（2025年）速度最快的 Python 包管理和虚拟环境工具之一，
它能把传统的 python -m venv + pip install 流程提速 1-2 个量级，
同时 完全兼容 pip 的命令和 requirements.txt 文件，几乎零学习成本。

以下是目前最常用、最丝滑的入门流程，推荐所有 Python 项目都这样开始。

推荐的标准初始化流程（3 行命令）

# 1. 进入项目目录
cd your-project

# 2. 创建虚拟环境 + 自动激活（一行完成）
uv venv

# 3. 安装项目依赖（支持 requirements.txt、pyproject.toml 等）
uv pip install -r requirements.txt
# 或者直接用 uv 自带的同步命令（更推荐）：
# uv sync

等效的传统写法（对比用）：

cd your-project
python -m venv .venv
source .venv/bin/activate    # Windows 用 .venv\Scripts\activate
pip install -r requirements.txt

为什么很多人现在都写成这样（更简洁版）

# 2025 年最流行的写法（一行创建 + 激活）
cd project
uv venv && source .venv/bin/activate

# 安装依赖（uv pip 完全兼容 pip）
uv pip install -r requirements.txt

# 或者用 uv 推荐的更现代写法
uv sync

Windows 用户请把第二行改成：

uv venv && .venv\Scripts\activate

常用命令速查表

进阶但很实用的几种写法

1. 最简一行党写法（Linux/macOS）

   cd project && uv venv && source .venv/bin/activate && uv pip install -r requirements.txt
   

2. 使用 uv sync（强烈推荐）

   如果项目有 pyproject.toml 或 uv.lock 文件，直接运行：

   uv sync
   

   它会：

   • 自动创建 .venv（如果没有）
   • 安装/同步所有依赖
   • 生成精确锁文件（uv.lock）

3. 每次打开终端自动激活（可选）

   在项目根目录创建 .envrc 文件（需安装 direnv）：

   source .venv/bin/activate
   

   然后在项目目录运行 direnv allow 即可自动激活。

小结：uv vs 传统 venv + pip

一句话总结：

想让 Python 项目启动快 10 倍，又不想学新工具？
那就从今天开始把 python -m venv 换成 uv venv 吧！

祝你开发愉快，安装依赖不再等待～ 🚀