UV 安装

User: uv 安装
Kimi: 以下是几种常见的 UV 安装方法：

使用独立安装程序

• macOS/Linux：

  curl -LsSf https://astral.sh/uv/install.sh | sh
  

  或者使用 wget：

  wget -qO- https://astral.sh/uv/install.sh | sh
  

• Windows（PowerShell）：

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

使用 PyPI 安装

• 推荐使用 pipx（隔离环境）：

  pipx install uv
  

• 直接使用 pip：

  pip install uv
  

使用其他包管理工具安装

• Homebrew（macOS）：

  brew install uv
  

• WinGet（Windows）：

  winget install --id=astral-sh.uv -e
  

• Scoop（Windows）：

  scoop install uv
  

使用 Docker 安装

UV 提供了 Docker 镜像，可以通过以下命令运行：

docker run -it ghcr.io/astral-sh/uv

使用 Cargo 安装（Rust 用户）

如果系统已安装 Rust，可以通过 Cargo 安装：

cargo install --git https://github.com/astral-sh/uv uv

从 GitHub Releases 下载

可以直接从 GitHub Releases 页面下载预编译的二进制文件。

安装完成后，可以通过以下命令验证 UV 是否安装成功：

uv --version

如果返回版本信息，则说明安装成功。
User: 怎么安装预编译的uv 文件
Kimi: 安装预编译的 UV 文件可以通过以下步骤完成：

从 GitHub Releases 下载预编译文件

1. 访问 UV 的 GitHub Releases 页面：
   打开 UV GitHub Releases 页面。
2. 选择适合您系统的预编译文件：
   根据您的操作系统（如 Windows、macOS、Linux）和架构（如 x86_64 或 arm64），下载对应的预编译文件。例如：
   • Windows 64 位系统：下载 uv-x86_64-pc-windows-msvc.zip。
   • macOS 或 Linux 系统：下载对应的 .tar.gz 文件。
3. 解压下载的文件：
   将下载的文件解压到一个指定的目录，例如 C:\Program Files\uv（Windows）或 ~/bin/uv（macOS/Linux）。

将 UV 添加到系统环境变量

1. Windows 系统：
   • 打开“系统属性” > “高级” > “环境变量”。
   • 在“系统变量”中找到 Path，点击“编辑”。
   • 添加 UV 的安装路径（如 C:\Program Files\uv）。
2. macOS/Linux 系统：
   • 打开终端，运行以下命令将 UV 的路径添加到环境变量：

     echo 'export PATH=$PATH:/path/to/uv' >> ~/.bashrc
     source ~/.bashrc
     

     或者使用 ~/.zshrc 文件，具体取决于您使用的 shell。

验证安装

在终端或命令提示符中运行以下命令，验证 UV 是否安装成功：

uv --version

如果返回 UV 的版本信息，则说明安装成功。

如果在安装过程中遇到问题，可以参考 UV 的官方安装指南或安装脚本。
User: uv 使用方法
Kimi: UV 是一个强大的 Python 包和项目管理工具，以下是其常用使用方法和功能详解：

1. 基本命令

• 查看帮助信息：

  uv --help
  

• 检查 UV 版本：

  uv --version
  

2. Python 环境管理

• 查看已安装的 Python 版本：

  uv python list --only-installed
  

• 设置默认 Python 版本：

  uv python pin 3.10
  

  这会在当前目录下创建 .python-version 文件，指定项目使用的 Python 版本。
• 运行 Python 脚本：

  uv run script.py
  

  如果有多个 Python 版本，UV 会根据 .python-version 文件或默认设置选择版本。

3. 项目初始化

• 创建新项目：

  uv init my_project
  cd my_project
  

  该命令会生成项目的基本结构，包括 pyproject.toml、.gitignore 等文件。

4. 依赖管理

• 添加依赖：

  uv add requests
  uv add "flask>=2.0,<3.0"
  uv add git+https://github.com/psf/requests.git
  

  依赖会自动添加到 pyproject.toml 文件中，并更新 .venv 环境。
• 移除依赖：

  uv remove requests
  

• 更新依赖：

  uv lock --upgrade-package requests
  uv sync
  

  或直接升级所有依赖：

  uv lock --upgrade
  uv sync
  

• 安装项目依赖：

  uv pip install -e .
  

5. 虚拟环境管理

• 创建虚拟环境：

  uv venv
  

  或指定 Python 版本和环境名称：

  uv venv -p python3.10 my_env
  

• 删除虚拟环境：

  uv venv --remove my_env
  

6. 运行工具

• 临时运行工具：

  uv tool run black .
  uvx ruff check .
  

  uvx 是 uv tool run 的简写。
• 安装全局工具：

  uv tool install black
  

• 列出已安装工具：

  uv tool list
  

7. 其他功能

• 运行脚本：

  uv run script.py
  

  或从标准输入运行：

  echo 'print("hello world!")' | uv run -
  

• 导出依赖：

  uv pip freeze > requirements.txt
  

UV 提供了类似 pip、pipx、poetry 等工具的功能，但性能更高，且支持更复杂的项目结构。