用UV创建项目
使用命令:
bash
uv init <项目名称>
即可创建项目。

通过uv init
创建的项目自带gitignore
等相关配置文件。

其中python-version
和pyproject.toml
是UV
用来管理虚拟环境的关键。python-version
指定这个项目使用的python版本;而pyproject.toml
是项目的说明书,包含了项目的名称、版本、依赖等内容,相当于setup.py
和requirements.txt

用UV管理环境
UV不需要手动激活虚拟环境环境,会自动使用对应的程序。UV会根据pyproject.toml
来管理项目的依赖。
使用UV安装依赖
bash
uv add <包的名称>
虚拟环境创建好了,包也安装了。
pyproject.toml
中的依赖也同步更新了。
并且通过uv add
安装库比pip install
速度更快。
使用UV运行程序
不需要激活虚拟环境,使用命令
bash
uv run <文件名称>
uv run
自动匹配了相应的环境。
使用UV重现项目环境
根据pyproject.toml
中的依赖,可以以下命令重现项目的虚拟环境:
bash
uv sync
创建了新的符合项目依赖的虚拟环境。
用UV管理命令行工具
多个项目会用到某些命令行工具,例如pytest
进行测试。对此可以进行全局安装,而不是安装到项目环境中:
bash
uv tool install <命令行工具>

创建临时虚拟环境
对于某些临时运行的脚本,不需要为它们单独创建虚拟环境,只需要在使用UV创建项目的命令添加--script
参数:
bash
uv init --script <脚本名称>

脚本文件内容会多了一些元数据。UV会根据这些元数据创建临时的虚拟环境来安装依赖,来运行脚本。
