## 安装步骤

### 1. 安装 Python
确保你已安装 Python 3.9 或更高版本。你可以从 [Python 官方网站](https://www.python.org/downloads/) 下载并安装。

验证 Python 是否安装成功：
```bash
python --version
```

### 2. 安装 virtualenv
`virtualenv` 是一个用于创建隔离的 Python 环境的工具。如果尚未安装，请运行以下命令：
```bash
pip install virtualenv
```

### 3. 创建虚拟环境
在项目根目录下运行以下命令，创建一个虚拟环境：
```bash
virtualenv venv
```

激活虚拟环境：
- **Windows**：
  ```bash
  .\venv\Scripts\activate
  ```
- **Linux/macOS**：
  ```bash
  source venv/bin/activate
  ```

### 4. 安装依赖
在虚拟环境中，运行以下命令安装项目依赖：
```bash
pip install -r requirements.txt
```

`requirements.txt` 文件包含了项目所需的所有依赖及其版本。确保该文件位于项目根目录下。

### 5. 运行项目
在虚拟环境中，运行以下命令启动项目：
```bash
python main.py
```

如果项目包含多个脚本，根据需要运行相应的脚本文件。

## 示例结构
以下是项目的文件结构示例：
```
project-root/
├── README.md
├── requirements.txt
├── main.py
├── data/
│   └── example.txt
└── venv/
```

## 注意事项
1. **虚拟环境**：始终在虚拟环境中运行项目，以避免全局环境的依赖冲突。
2. **依赖更新**：如果需要更新依赖，请运行以下命令：
   ```bash
   pip install --upgrade -r requirements.txt
   ```
3. **退出虚拟环境**：运行 `deactivate` 命令退出虚拟环境。