安装

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
UV_CACHE_DIR=E:\uv-cache # 指定中间缓存文件夹，需要与项目目录在同一个 挂载点/盘符 下
$env:UV_LINK_MODE = "symlink" # 符号链接，不建议
curl -LsSf https://astral.sh/uv/install.sh | sh
source ~/.bashrc

# 配置UV镜像
export UV_DEFAULT_INDEX="https://mirrors.aliyun.com/pypi/simple/"
https_proxy=http://127.0.0.1:7890 http_proxy=http://127.0.0.1:7890 uv self update

# 导出标准 requirements.txt 格式
uv pip freeze > requirements.txt
# 把所有冻结的依赖写入 [project.dependencies] 
uv add -r requirements.txt

uv init --python 3.10

Feature

  1. 使用 python 来管理 python 版本：
    1. uv python install：安装 Python 版本
    2. uv python list：查看可用的 Python 版本
    3. uv python find：查找已安装的 Python 版本
    4. uv python pin：将当前项目固定为使用特定的 Python 版本
    5. uv python uninstall：卸载 Python 版本
  2. 脚本
    • uv run：运行脚本
    • uv add --script：向脚本添加依赖项
    • uv remove --script：从脚本中删除依赖项
  3. 创建和处理 Python 项目，即带有 pyproject.toml 的项目
    • uv init：创建一个新的 Python 项目
    • uv add：向项目添加依赖项
    • uv remove：从项目中删除依赖项
    • uv sync：将项目的依赖项与环境同步
    • uv lock：为项目的依赖项创建锁文件
    • uv run：在项目环境中运行命令
    • uv tree：查看项目的依赖关系树
    • uv build：将项目构建为分发归档
    • uv publish：将项目发布到包索引
  4. 运行和安装发布到 Python 仓库的工具，例如 ruff 或 black
    • uvx / uv tool run：在临时环境中运行工具
    • uv tool install：在用户范围内安装工具
    • uv tool uninstall：卸载工具
    • uv tool list：列出已安装的工具
    • uv tool update-shell：更新 shell 以包含工具可执行文件
  5. 手动管理环境和包
    • uv venv：创建一个新的虚拟环境
    • uv pip install：将包安装到当前环境中
    • uv pip show：显示有关已安装包的详细信息
    • uv pip freeze：列出已安装的包及其版本
    • uv pip check：检查当前环境是否具有兼容的包
    • uv pip list：列出已安装的包
    • uv pip uninstall：卸载包
    • uv pip tree：查看环境的依赖关系树
    • uv pip compile：将需求编译为锁文件
    • uv pip sync：将环境与锁文件同步
  6. 实用工具
    • uv cache clean：删除缓存条目
    • uv cache prune：删除过时的缓存条目
    • uv cache dir：显示 uv 缓存目录路径
    • uv tool dir：显示 uv 工具目录路径
    • uv python dir：显示 uv 已安装的 Python 版本路径
    • uv self update：将 uv 更新到最新版本