python包管理器uv工具的使用

方式一 官方安装脚本（推荐）
执行：curl -LsSf https://astral.sh/uv/install.sh| sh
安装完成后按提示将 $HOME/.local/bin​ 加入 PATH（脚本通常会自动写入，如未写入可手动追加到 ~/.bash_profile​ 或 ~/.bashrc​ 并执行 source 使其生效）。


方式二 使用 pip 安装
建议先准备 Python ≥ 3.8​ 与 pip，然后执行：pip install uv
验证：uv --version 应输出版本号（如 0.9.x）

创建虚拟环境命令：uv venv .venv

例子：
root@vm-01:~/apps/code/cmdb
> uv venv .venv
Using CPython 3.12.11 interpreter at: /usr/local/miniforge3/bin/python3
Creating virtual environment at: .venv
Activate with: source .venv/bin/activate

(.venv) (base) 
root@vm-01:~/apps/code/cmdb
> ls -la
total 0
drwxr-xr-x 3 root root 19 Nov 21 17:29 .
drwxr-xr-x 3 root root 18 Nov 21 17:29 ..
drwxr-xr-x 4 root root 97 Nov 21 17:29 .venv

创建虚拟环境命令 uv venv .venv --python=3.9.12 （需系统已安装对应 python3.x）

例子：
root@vm-01:~/apps/code/cmdb
> rm -fr .venv   # 删除之前的虚拟环境

root@vm-01:~/apps/code/cmdb
> uv venv .venv --python=3.9.12   # 如果本地不存在对应的版本，会自动去网上下载
Using CPython 3.9.12
Creating virtual environment at: .venv
Activate with: source .venv/bin/activate
(.venv) (base) 
root@vm-01:~/apps/code/cmdb
> ls -la
total 0
drwxr-xr-x 3 root root 19 Nov 21 17:30 .
drwxr-xr-x 3 root root 18 Nov 21 17:29 ..
drwxr-xr-x 4 root root 97 Nov 21 17:30 .venv

可以看下目前的python版本，可以看到默认已经激活了当前的虚拟环境
(.venv) (base) 
root@vm-01:~/apps/code/cmdb
> python --version
Python 3.14.0

切换到项目目录下，执行 source .venv/bin/activate

安装包：uv pip install 包名 或 uv pip install -r requirements.txt

生成锁定文件：uv pip compile pyproject.toml -o requirements.txt

精确同步环境：uv pip sync requirements.txt

uv pip install 具体的包名 -i https://pypi.tuna.tsinghua.edu.cn/simple

在这个文件中，你可以指定你想要的包和可选的版本约束。
# requirements.txt
requests>=2.28.0
click~=8.0.0
black

这个命令会解析 requirements.txt 中的依赖关系，并递归地解决所有传递依赖，最终生成一个完全锁定的 requirements.lock 文件。
uv pip compile requirements.txt -o requirements.lock

说明：
uv pip compile: 这是用于生成锁定文件的命令。
requirements.txt: 输入的依赖规范文件。
-o requirements.lock: 指定输出的锁定文件名。

执行后，你会得到一个 requirements.lock 文件。它的内容类似于：
# This file was autogenerated by uv via the following command:
#    uv pip compile requirements.txt -o requirements.lock
black==25.11.0
	# via -r requirements.txt
certifi==2025.11.12
	# via requests
charset-normalizer==3.4.4
	# via requests
click==8.0.4
	# via
	#   -r requirements.txt
	#   black
idna==3.11
	# via requests
mypy-extensions==1.1.0
	# via black
packaging==25.0
	# via black
pathspec==0.12.1
	# via black
platformdirs==4.5.0
	# via black
pytokens==0.3.0
	# via black
requests==2.32.5
	# via -r requirements.txt
urllib3==2.5.0
	# via requests

在 pyproject.toml 中定义依赖：
# pyproject.toml
[
build-system
]
requires = ["setuptools>=45", "wheel"]
build-backend = "setuptools.build_meta"

[
project
]
name = "my-project"
version = "0.1.0"
dependencies = [
	"requests>=2.28.0",
	"click~=8.0.0",
	"black",
]


编译并生成锁定文件：
uv pip compile pyproject.toml -o requirements.lock
uv 会自动识别 pyproject.toml 并从中提取 [project.dependencies]。

如果你想将当前虚拟环境中已安装的所有包的状态锁定下来，可以使用 pip freeze 的方式，然后用 uv 编译。

# 首先，生成当前环境的包列表
pip freeze > requirements-frozen.txt

# 然后，让 uv 基于这个冻结的列表生成带有哈希的锁定文件
uv pip compile requirements-frozen.txt -o requirements.lock

注意：这不如前两种方法推荐，因为它可能包含一些不必要的传递依赖或开发工具。

> uv pip install -r requirements.lock