6a81b7bb13
Some checks reported errors
continuous-integration/drone/push Build was killed
- 搭建 api、auth、utils 等逻辑模块 - 通过 tsc、eslint、vitest 测试验证 BREAKING CHANGE: 新镜像分支
36 lines
1.1 KiB
Markdown
36 lines
1.1 KiB
Markdown
# Utils 模块
|
||
|
||
## 架构设计
|
||
|
||
Utils 模块采用工具函数库模式，按功能域组织，提供常用的数据处理、字符串操作、日期处理和验证功能。
|
||
|
||
## 核心组件
|
||
|
||
1. **数据处理工具 (data.ts)**
|
||
- 深拷贝、防抖、节流等常用函数
|
||
- 数组操作：去重、分组、排序、分页
|
||
- 对象转换：数组转对象
|
||
|
||
2. **字符串处理工具 (string.ts)**
|
||
- 格式转换：驼峰、短横线、下划线命名
|
||
- 字符串操作：截断、首字母大写、HTML处理
|
||
- 工具函数：随机字符串、空值检查
|
||
|
||
3. **日期处理工具 (date.ts)**
|
||
- 日期格式化和相对时间计算
|
||
- 日期比较：今天、昨天判断
|
||
- 灵活的格式化模板
|
||
|
||
4. **验证工具 (validation.ts)**
|
||
- 常用验证：邮箱、手机号、URL、身份证
|
||
- 数据验证：空值、范围、长度、类型
|
||
- 日期和数字验证
|
||
|
||
## 设计原则
|
||
|
||
1. **纯函数**：所有工具函数都是纯函数，无副作用
|
||
2. **类型安全**：充分利用 TypeScript 类型系统
|
||
3. **模块化**：按功能域组织，按需导入
|
||
4. **一致性**：统一的命名和参数设计
|
||
|