安装 Uv

官方推荐：

curl -Ls https://astral.sh/uv/install.sh | sh

或用 pip：

pip install uv

检查版本：

uv --version

创建项目

初始化新项目：

uv init myproj
cd myproj

会生成：

pyproject.toml
基本目录结构

虚拟环境管理

创建虚拟环境：

uv venv

激活：

Linux/macOS：

source .venv/bin/activate

Windows：

.venv\Scripts\activate

删除环境：

rm -rf .venv

安装依赖（核心）

安装包：

uv pip install requests

安装到虚拟环境（推荐）：

uv add requests

安装开发依赖：

uv add --dev pytest

移除依赖：

uv remove requests

同步依赖

根据 lock 文件同步：

uv sync

生成锁文件：

uv lock

运行 Python / 工具

运行脚本（自动使用虚拟环境）：

uv run python main.py

运行模块：

uv run python -m mymodule

运行 CLI 工具：

uv run pytest

直接运行工具（不用手动安装）

例如临时用 black：

uvx black .

运行 ruff：

uvx ruff check .

uvx = 类似 pipx，临时运行工具。

requirements.txt 兼容

安装 requirements：

uv pip install -r requirements.txt

导出：

uv pip freeze > requirements.txt

Python 版本管理

查看可用 Python：

uv python list

安装指定版本：

uv python install 3.11

指定版本创建环境：

uv venv --python 3.11

常用工作流

新项目

uv init myproj
cd myproj
uv venv
uv add fastapi
uv run python main.py

现有项目

uv venv
uv sync
uv run python main.py

最小记忆集合

uv init
uv venv
uv add package
uv sync
uv run python main.py
uvx tool

hw

Explorer

uv