41 lines
2.1 KiB
Markdown
41 lines
2.1 KiB
Markdown
|
# 测试报告 (TEST.md)
|
||
|
|
|
||
|
|
本文件记录了 `@go/file` 的测试覆盖场景、Benchmark 结果及系统鲁棒性测试情况。
|
||
|
|
|
||
|
|
## 1. 测试场景覆盖
|
||
|
|
|
||
|
|
### 文件系统操作 (TestFileSystemOps)
|
||
|
|
- **Copy**: 测试了文件从源到目的地的递归复制，验证了文件内容的一致性。
|
||
|
|
- **Move**: 验证了文件移动操作，确保源文件被删除且目标文件存在。
|
||
|
|
- **Replace**: 验证了在文件中进行原地文本替换的准确性。
|
||
|
|
- **Remove**: 验证了递归删除功能的鲁棒性。
|
||
|
|
|
||
|
|
### 目录与检索 (TestSearchAndDir)
|
||
|
|
- **Search**: 测试了在嵌套目录结构中通过通配符 `*.txt` 检索文件的能力。
|
||
|
|
- **ReadDir**: 验证了目录读取功能，支持内存模拟环境与磁盘真实环境的一致性。
|
||
|
|
|
||
|
|
### 内存文件系统 (TestMemoryDeep & TestMemoryLoadAPI)
|
||
|
|
- **递归加载**: 验证了 `LoadFileToMemory` 对多级子目录的递归处理。
|
||
|
|
- **B64 & 压缩链路**: 测试了文件 -> B64 序列化 -> JSON 存储 -> 内存恢复的全链路完整性。
|
||
|
|
- **SafeBuf 安全链路**: 验证了数据被 `SafeBuf` 加密存储后，解密内容的正确性，以及 `Close()` 对内存的擦除能力。
|
||
|
|
- **并发写入**: 验证了 `MarshalFile` 在高并发写入场景下的数据完整性。
|
||
|
|
|
||
|
|
### 序列化与智能映射 (TestUnmarshal & TestMarshal)
|
||
|
|
- **智能映射 (SmartMapping)**: 验证了 `UnmarshalFile` 能将 `user_name` (snake_case) 自动映射到结构体的 `UserName` (CamelCase) 字段，无需手动配置。
|
||
|
|
- **pretty 输出**: 验证了 `MarshalFilePretty` 输出带格式的 JSON/YAML。
|
||
|
|
|
||
|
|
## 2. 性能基准测试 (Benchmark)
|
||
|
|
|
||
|
|
在 Intel(R) Core(TM) i9-9980HK CPU @ 2.40GHz 环境下：
|
||
|
|
|
||
|
|
| Benchmark | ops | 耗时 (ns/op) |
|
||
|
|
| :--- | :--- | :--- |
|
||
|
|
| MarshalFile/Normal | 10000 | 111,770 |
|
||
|
|
| MarshalFile/Pretty | 10000 | 109,581 |
|
||
|
|
| UnmarshalFile/Normal | 52528 | 22,172 |
|
||
|
|
| UnmarshalFile/X | 46568 | 24,833 |
|
||
|
|
|
||
|
|
## 3. 系统鲁棒性测试
|
||
|
|
- **不存在的文件**: 验证 `UnmarshalFile` 返回 `os.IsNotExist` 类型错误。
|
||
|
|
- **非法格式**: 验证输入非法格式文件（如 `{invalid}`）时，系统正确返回解析错误，拒绝执行，严禁 Panic。
|