# UVM 安装指南

## 系统要求

- Python 3.9 或更高版本
- UV 包管理器 (推荐) 或 pip
- 支持 Windows、macOS、Linux

## 安装方法

### 方法一：使用 pip 安装 (推荐)

```bash
pip install uvm
```

### 方法二：使用 uv 安装

```bash
# 如果尚未安装 uv
curl -LsSf https://astral.sh/uv/install.sh | sh

# 安装 uvm
uv pip install uvm
```

### 方法三：从源码安装

```bash
git clone https://github.com/your-org/uvm.git
cd uvm
pip install -e .
```

## 验证安装

安装完成后，运行以下命令验证：

```bash
uvm --version
uvm --help
```

如果看到版本信息和帮助文档，说明安装成功。

## 快速开始

### 1. 查看当前镜像源
```bash
uvm current
```

### 2. 列出所有可用镜像源
```bash
uvm list
```

### 3. 切换到国内镜像源
```bash
uvm use tsinghua    # 清华大学镜像源
# 或
uvm use aliyun      # 阿里云镜像源
```

### 4. 测试镜像源速度
```bash
uvm test
```

## 常见问题

### Q: 安装时出现权限错误
A: 使用用户模式安装：
```bash
pip install --user uvm
```

### Q: 命令不识别
A: 确保 Python 脚本目录在 PATH 中：
- Windows: `%APPDATA%\Python\Python3X\Scripts`
- macOS/Linux: `~/.local/bin`

### Q: uv 命令不存在
A: 先安装 uv：
```bash
# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
```

## 卸载

```bash
pip uninstall uvm
```

## 下一步

安装完成后，建议查看：
- [README.md](README.md) - 详细使用说明
- [PUBLISH.md](PUBLISH.md) - 发布指南

## 获取帮助

如果遇到问题，可以：
1. 查看 GitHub Issues: https://github.com/your-org/uvm/issues
2. 查看文档: https://github.com/your-org/uvm#readme
3. 运行 `uvm --help` 查看命令帮助