UV

这是一个全能的python包管理工具
【全面掌握UV：Python下一代环境管理懒人工具（Python五分钟）】 https://www.bilibili.com/video/BV15MVdzaEUw/?share_source=copy_web&vd_source=9c987ed6ab5014f976c5bd5305300cc0

安装

1
2
3
4
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

# 直接安装到 /usr/local/bin，这样所有用户（pi, root）都能直接用
curl -LsSf https://astral.sh/uv/install.sh | sudo INSTALLROOT=/usr/local/bin sh

代替pip

1
2
3
4
5
uv run <main.py> 直接运行python文件

uv add --script 添加依赖到单个python文件

uv remove --script 删除依赖到单个python文件

uv add --script 中的 --script 参数是 uv 工具中一个非常实用的功能，它的核心作用是为独立的 Python 脚本文件（而非完整的项目）声明和管理依赖，让脚本能够“自包含”其运行环境信息。

项目管理：代替venv创建虚拟环境

创建和开发带有 pyproject.toml 的 Python 项目。

项目开发 | uv 中文文档

常用命令

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
# 初始化
uv init hello-world

# 运行main.py
uv run main.py

# 添加依赖
uv add requests
# 指定版本约束 
uv add 'requests==2.31.0'
# 从 `requirements.txt` 添加所有依赖项。 
uv add -r requirements.txt -c constraints.txt

# 删除依赖
uv remove requests

# 同步环境，一下下载所需依赖
uv sync

# 打包构建
uv build

创建虚拟环境

1
uv venv <projectName> --python 3.12

使用默认虚拟环境名称时，uv 在后续调用过程中会自动查找并使用该虚拟环境。

使用UV进行python版本管理

安装和管理 Python 解释器本身。

1
2
3
4
5
`uv python install`: 安装 Python 版本
`uv python list`: 查看可用 Python 版本
`uv python find`: 查找已安装的 Python 版本
`uv python pin`: 将当前项目固定使用特定 Python 版本
`uv python uninstall`: 卸载 Python 版本

配置国内镜像

修改 pyproject.toml

1
2
3
4
[[tool.uv.index]]
name = "aliyun"
url = "https://mirrors.aliyun.com/pypi/simple/"
#url = "http://mirrors.cloud.aliyuncs.com/pypi/simple/" # 内网

快速设置 uv 默认源为国内镜像 | uv 中文文档()

root用户

直接复制到/usr/local/bin里面

1
2
3
4
5
6
7
8
9
# 1. 确认 pi 用户下 uv 的具体路径
which uv

# 2. 创建软链接 (假设路径是 /home/pi/.local/bin/uv)
sudo ln -s /home/pi/.local/bin/uv /usr/local/bin/uv
sudo ln -s /home/pi/.local/bin/uvx /usr/local/bin/uvx

# 3. 验证 root 是否可用
sudo uv --version