使用 uv 进行 python 项目管理
文章目录
- Why UV？
- 安装 Installation
- UV 项目开发
- 项目结构
- 依赖包管理
- Python 环境管理
- UV 项目构建和发布
Why UV？
- 通过
pyproject.tomlheuv.lock文件进行项目依赖管理，同时允许开发者在项目中进行不同 python 环境的管理和切换，单一命令实现完整的项目管理，无需pip，venv等其他工具。 - 比
pip10 倍以上更加便利快捷的依赖包管理
安装 Installation
Linux 和 MacOS 上的安装命令：
curl-LsSfhttps://astral.sh/uv/install.sh|shwindows 安装命令：
powershell-ExecutionPolicy ByPass-c"irm https://astral.sh/uv/install.ps1 | iex"其中，-ExecutionPolicy ByPass用于临时修改 Windows 的安全策略限制，允许在 PowerShell 中执行 psl 脚本。
安装完成之后，默认情况下终端并不了解 uv 的命令补全规则，需要额外让终端在启动时加载 uv 的补全规则：
echo'eval "$(uv generate-shell-completion bash)"'>>~/.bashrcWindows:
if(!(Test-Path-Path$PROFILE)){New-Item-ItemType File-Path$PROFILE-Force}Add-Content-Path$PROFILE-Value'(& uv generate-shell-completion powershell) | Out-String | Invoke-Expression'安装完成之后，可以直接运行uv命令，查看 help 内容。
UV 项目开发
项目结构
项目是 uv 的核心概念，通过uv init [your-project-name]可以初始化创建一个项目，初始化的目录结构如下：
. ├── .python-version ├── README.md ├── main.py └── pyproject.toml例如uv init hello-world：
其中，main.py文件为主入口文件，包含简单的示例代码：
defmain():print("Hello from hello-world!")if__name__=="__main__":main()uv 通过一个pyproject.toml文件来描述这个 uv 项目，这是 uv 项目的核心文件，包含了这个项目的所有元数据比如项目名称、依赖等内容：
[project] name = "hello-world" version = "0.1.0" description = "Add your description here" readme = "README.md" requires-python = ">=3.13" dependencies = []通过执行uv run main.py可以执行 python 脚本：
执行之后，项目下会额外生成一个uv.lock锁文件以及.venv/目录：
其中：
uv.lock是 uv 项目依赖的 python 包的版本信息锁文件，.venv/是管理项目的 python 虚拟环境的文件夹，与系统的其他 python 环境相互隔离，uv 可以允许用户在一个项目中进行不同 python 环境的切换。初始化项目之后，默认的 python 环境是 uv 安装时携带的 python 环境，可以通过uv python命令查看当前项目的 python 环境，进行其他版本的 python 环境安装，切换环境等管理操作
初始化完成之后，后续就可以根据具体项目需求，使用 flask 等后台代码框架进行应用代码的初始化和开发了。
依赖包管理
uv 安装依赖包的方式如下
uvadd[package]uv pipinstallflask可以使用与 pip 一样的方式使用==, >=, <=指定版本，或者版本条件安装进行安装：
uv pipinstall'ruff>=0.2.0'一些依赖包设置了额外的依赖选项，需要通过package[option]的方式指定依赖项安装：
uv pipinstall"flask[dotenv]"Python 环境管理
uv 项目中，一般通过uv venv创建虚拟环境（类似 conda）：
uv venv--python3.12使用uv python命令进行 python 环境管理：
# 常用，安装指定版本uv pythoninstall[version]uv pythoninstall3.12# 根据项目要求安装满足条件的版本uv pythoninstall'>=3.8,<3.10'# 安装多版本uv pythoninstall3.93.103.11UV 项目构建和发布
通过build命令进行项目的构建，uv 可以支持构建whleel分发包（.whl）以及源码分发包--sdist（.tar.gz）两种形式：
uv build--wheel# --sdist运行完成之后，将会在项目根目录下面生成build/和dist/两个文件夹，dist文件夹下面即包含了构建完成的可发布的结果。