# fastcheck

**Repository Path**: MM-Q/fastcheck

## Basic Information

- **Project Name**: fastcheck
- **Description**: FastCheck 是一个用于快速校验文件完整性和计算文件或目录大小的工具。它支持多种哈希算法（如 MD5、SHA1 和 SHA256），并能够通过并行处理提高效率。
- **Primary Language**: Go
- **License**: GPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-01-22
- **Last Updated**: 2025-03-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# FastCheck：快速文件校验与大小计算工具

## 用途和特点

FastCheck 是一个用于快速校验文件完整性和计算文件或目录大小的工具。它支持多种哈希算法（如 MD5、SHA1 和 SHA256），并能够通过并行处理提高效率。

1. **支持多种哈希算法**：可以选择 MD5、SHA1 或 SHA256 算法来校验文件。
2. **并行处理**：通过并发任务加速文件校验和大小计算。
3. **递归扫描目录**：可以递归扫描目录并计算目录中所有文件的大小或生成校验码。
4. **校验文件完整性**：可以生成校验文件，并根据校验文件检查文件完整性。
5. **文件大小计算**：支持计算单个文件或目录的大小，并以人类可读的格式显示。
6. **结果保存**：可以将校验结果保存到文件中。

## 参数和用法

### 命令行参数

| 参数      | 说明                                              |
| --------- | ------------------------------------------------- |
| `-c`      | 根据校验文件检查文件完整性。                      |
| `-cs`     | 计算文件或目录的大小。                            |
| `-r`      | 开启递归扫描目录。                                |
| `-j`      | 设置并发任务数（默认为 3）。                      |
| `-w`      | 将校验结果保存到文件中。                          |
| `-o`      | 指定校验文件的保存路径（默认为 `checksum.txt`）。 |
| `-size`   | 显示文件大小（单位：B, KB, MB, GB, TB）。         |
| `-md5`    | 使用 MD5 算法校验文件（默认）。                   |
| `-sha1`   | 使用 SHA1 算法校验文件。                          |
| `-sha256` | 使用 SHA256 算法校验文件。                        |
| `-v`      | 显示版本信息。                                    |

### 常用命令示例

1. **生成校验文件**：

   ```bash
   fastcheck -r -w -o checksum.txt /path/to/directory
   ```

   递归扫描目录并生成校验文件，保存到 `checksum.txt`。

2. **检查文件完整性**：

   ```bash
   fastcheck -c checksum.txt
   ```

   根据校验文件检查文件完整性。

3. **计算文件大小**：

   ```bash
   fastcheck -cs /path/to/file.txt
   ```

   计算单个文件的大小。

4. **计算目录大小**：

   ```bash
   fastcheck -cs /path/to/directory
   ```

   计算目录的总大小。

5. **并行计算文件大小**：

   ```bash
   fastcheck -cs -j 5 /path/to/directory/*
   ```

   使用 5 个并发任务计算目录中所有文件的大小。

## 下载和使用

### 下载

可以通过以下方式获取 FastCheck 的源代码：

```bash
git clone https://gitee.com/MM-Q/fastcheck.git
cd fastcheck
```

### 编译

确保已安装 Go 环境，然后运行以下命令进行编译：

```bash
go build -o fastcheck
```