uv 命令

1uv venv                                    # 在当前目录创建一个 .venv 虚拟环境
2uv venv --python 3.12        # 创建指定 python 版本的虚拟环境
3
4uv python list                     # 查看可用的 python 版本
5uv python find                    # 查找已安装的 Python 版本
6uv python pin 3.11            # 在当前目录中使用特定的 Python 版本
7uv python install             # 安装最新的 python 版本
8uv python install 3.12    # 安装特定 python 版本
9uv python uninstall            # 卸载一个 Python 版本
10uv python dir                     # 显示 uv 安装的 Python 版本路径
11uv python install 3.12 --default    # 将 uv 管理的 Python 添加到系统环境变量
12
13uv run                                     # 运行脚本
14uv run --python 3.10 example.py    # 脚本调用时请求任意 Python 版本
15uv remove 'requests==2.31.0' # 脚本中删除依赖项
16uv add 'requests==2.31.0'    # 向脚本添加依赖项
17uv add -r requirements.txt    # 将 requirements.txt 中的依赖项全部加入项目配置 pyproject.toml
18
19uv pip install <package>                    # 在当前虚拟环境中安装包
20uv pip install -r requirements.txt    # 从 requirements.txt 中安装依赖
21uv pip install --upgrade <package>    # 升级已安装的包到最新版本
22uv pip uninstall <package>                # 卸载指定的包
23uv pip list                                    # 查看已安装的包列表
24uv pip show <package>                # 查看指定包的详细信息
25uv pip freeze                             # 列出已安装的软件包及其版本
26uv pip compile                             # 将需求 requirements 编译成锁文件
27uv pip sync                                    # 使用锁文件同步环境
28uv pip tree                                 # 查看环境的依赖树
29
30uvx / uv tool run         # 在临时环境中运行工具
31uv tool install             # 在用户范围内安装命令行工具（例如 modelscope）
32uv tool uninstall         # 卸载工具
33uv tool upgrade             # 升级工具
34uv tool list                     # 列出已安装的工具
35uv tool upgrade --all    # 一次性升级所有安装的工具
36uv tool update-shell     # 更新 shell 以包含工具可执行文件
37uv tool dir                     # 显示 uv 工具目录路径
38uv tool upgrade --python 3.10 <工具名称>    # 升级时还可以指定 Python 版本
39uv tool upgrade <工具名称> --reinstall # 强制重新安装所有包
40uv tool upgrade <工具名称> --reinstall-package <依赖包名称> # 只重新安装某个依赖包
41
42uv cache clean                # 清理 uv 的缓存
43uv cache prune                 # 删除过时的缓存条目
44uv cache dir                    # 显示 uv 的缓存目录
45
46uv init                                # 创建一个新的 Python 项目
47uv self update                # 独立安装版本自升级
48uv sync                                # 将项目的依赖项与环境同步
49uv lock                             # 为项目的依赖项创建一个锁文件
50uv tree                             # 查看项目的依赖树
51uv build                             # 将项目构建到分发档案中
52uv publish                         # 将项目发布到包索引
53uv help init                    # 查看特定命令的长帮助菜单
54uv version                        # 查看版本

uv 镜像管理

1# 永久设置阿里云镜像（环境变量）
2export UV_INDEX_URL=https://mirrors.aliyun.com/pypi/simple/
3source ~/.zshrc

1# 永久设置阿里云镜像（全局 uv 配置）
2mkdir -p ~/.config/uv
3cat > ~/.config/uv/uv.toml <<'EOF'
4index-url = "https://mirrors.aliyun.com/pypi/simple/"
5EOF
6
7# 设置阿里云镜像，在项目根目录创建 uv.toml，写入
8index-url = "https://mirrors.aliyun.com/pypi/simple/"
9
10# 或者写进 `pyproject.toml`
11[tool.uv]
12index-url = "https://mirrors.aliyun.com/pypi/simple/"

uv 工具安装 vllm 并添加额外依赖

1uv tool install vllm --with "modelscope>=1.18.1"
2
3uv tool install "xinference[vllm]" --with "vllm"
4
5uv tool install "xinference[vllm]" \
6  --with "vllm" \
7  --with sentence-transformers

uv 工具安装指定 python 版本

1uv tool install xinference --python 3.11

uv 命令自动补全

1echo 'eval "$(uv generate-shell-completion zsh)"' >> ~/.zshrc
2echo 'eval "$(uvx --generate-shell-completion zsh)"' >> ~/.zshrc