uv使用详解

一、uv使用详解

1、代码仓库：https://github.com/astral-sh/uv

2、官方文档：https://docs.astral.sh/uv

3、命令参数：https://docs.astral.sh/uv/reference/cli

4、安装工具：pip install uv

5、清理所有缓存：uv cache clean
6、清理过期缓存：uv cache prune

7、启动python(创建虚拟环境)：uvx python@3.12

8、启动python(不创建虚拟环境)：uv run --python 3.12 python

管理python：

1、安装目录：%APPDATA%\uv\python

2、启动器目录：%USERPROFILE%\.local\bin

3、显示安装版本情况：uv python list

4、查找执行文件位置：uv python find 3.14

5、安装python：uv python install 3.14

6、重装python：uv python install --reinstall 3.14

7、升级python：uv python upgrade 3.14

8、卸载python：uv python uninstall 3.14

09、固定python：uv python pin 3.12

10、固定python：uv python pin --global 3.12

管理工具：

1、安装目录：%APPDATA%\uv\tools
2、启动器目录：%USERPROFILE%\.local\bin

3、安装工具：uv tool install ruff

4、升级工具：uv tool upgrade ruff

5、卸载工具：uv tool uninstall ruff

6、增加工具PATH：uv tool update-shell

7、执行工具：uv tool run ruff

8、执行工具：uvx ruff

9、执行工具：uvx --from httpie http

10、执行工具：工具已安装，执行已安装工具；

11、执行工具：工具未安装，下载工具到临时目录，然后执行；

12、临时目录：%LOCALAPPDATA%\uv\cache\archive-v0

执行脚本：

1、存储依赖的虚拟环境：%LOCALAPPDATA%\uv\cache\archive-v0

2、执行脚本的虚拟环境：%LOCALAPPDATA%\uv\cache\builds-v0

3、执行脚本的虚拟环境：_uv_ephemeral_overlay.pth注入需要的依赖

4、执行脚本：uv run example.py

5、执行脚本：uv run --no-project example.py

6、执行脚本：uv run --with rich example.py

内联脚本元数据：

1、初始元数据：uv init --script example.py --python 3.12
2、添加元数据：uv add --script example.py 'requests<3' 'rich'

3、锁定依赖：uv lock --script example.py

4、执行脚本：uv run example.py

管理项目：

1、init以外的命令会在当前目录创建虚拟环境，创建锁定文件uv.lock

2、初始化项目：uv init hello-world

3、添加依赖：uv add requests

4、删除依赖：uv remove requests

5、升级依赖：uv lock --upgrade-package requests

6、锁定依赖：uv lock

7、安装依赖：uv sync
08、执行脚本：uv run main.py

09、执行命令：uv run -- flask --help

10、执行命令查找顺序：虚拟环境Scripts、PATH包含命令、真实环境Scripts

11、发布打包：uv build --wheel

12、发布打包：uv build --sdist

TOML文件格式：

1、规范网址：https://toml.io/en

2、代码仓库：https://github.com/hukkin/tomli

3、代码仓库：https://github.com/hukkin/tomli-w

4、pyproject.toml介绍：https://packaging.python.org/en/latest/guides/writing-pyproject-toml

5、toml介绍：作为配置文件，可读性非常好，而且不容易出错；

6、toml介绍：python 3.11开始内置tomllib，只能读取toml文件；

7、依赖安装：pip install tomli
8、依赖安装：pip install tomli-w