UV Cheatsheet

1. 安装与初始化

命令	参数/说明	示例
`irm https://astral.sh/uv/install.ps1	通过 PowerShell 安装（Windows）
`curl -LsSf https://astral.sh/uv/install.sh	通过 Shell 脚本安装（macOS/Linux）
pip install uv	通过 pip 安装
uv init <项目名>	初始化项目，生成 pyproject.toml 和 uv.lock，uv还会自动生成一个.git文件。	uv init myproject

2. 虚拟环境管理

命令	参数/说明	示例
uv venv	创建默认虚拟环境 .venv	uv venv
uv venv --seed -p <版本>	指定 Python 版本创建环境（需系统已安装）	uv venv -p 3.11
uv sync	同步依赖到虚拟环境，支持 --production（仅生产依赖）	uv sync --production
uv add <包名>	安装包并自动更新锁文件	uv add pandas
uv add --group <分组>	按分组安装依赖（如 dev/prod）	uv add --group dev pytest
uv remove <包名>	移除包并清理未使用的依赖	uv remove numpy
uv lock	生成或更新依赖锁文件 uv.lock	uv lock

3. 包管理（兼容 pip 语法）

命令	参数/说明	示例
uv pip install <包名>	安装包（支持 PyPI、Git、本地路径）	uv pip install git+https://github.com/user/repo
uv pip install -r <文件>	按文件批量安装依赖	uv pip install -r requirements.txt
uv pip install --upgrade	升级指定包	uv pip install --upgrade requests
uv pip list	列出已安装的包	uv pip list
uv pip freeze	导出依赖到文件	uv pip freeze > requirements.txt
uv pip uninstall	卸载包	uv pip uninstall package

4. Python 版本管理

命令	参数/说明	示例
uv python install <版本>	安装指定 Python 版本	uv python install 3.12
uv python list	查看已安装的 Python 版本	uv python list
uv python pin <版本>	固定项目使用的 Python 版本	uv python pin 3.11

5. 项目运行与调试

命令	参数/说明	示例
uv run <脚本>	在虚拟环境中运行脚本（支持参数传递）	uv run main.py --arg1 value
uv tree	显示依赖树	uv tree
uv cache clean	清理全局缓存（释放磁盘空间）	uv cache clean

6. 高级功能（Optional）

命令	参数/说明	示例
uv build	构建项目为可分发包（生成 dist/）	uv build
uv publish	发布包到 PyPI	uv publish
uv tool install <包名>	全局安装 CLI 工具（类似 pipx）	uv tool install impacket