Files
knowai/utils

Utils 模块

架构设计

Utils 模块采用工具函数库模式,按功能域组织,提供常用的数据处理、字符串操作、日期处理和验证功能。

核心组件

  1. 数据处理工具 (data.ts)

    • 深拷贝、防抖、节流等常用函数
    • 数组操作:去重、分组、排序、分页
    • 对象转换:数组转对象
  2. 字符串处理工具 (string.ts)

    • 格式转换:驼峰、短横线、下划线命名
    • 字符串操作截断、首字母大写、HTML处理
    • 工具函数:随机字符串、空值检查
  3. 日期处理工具 (date.ts)

    • 日期格式化和相对时间计算
    • 日期比较:今天、昨天判断
    • 灵活的格式化模板
  4. 验证工具 (validation.ts)

    • 常用验证邮箱、手机号、URL、身份证
    • 数据验证:空值、范围、长度、类型
    • 日期和数字验证

设计原则

  1. 纯函数:所有工具函数都是纯函数,无副作用
  2. 类型安全:充分利用 TypeScript 类型系统
  3. 模块化:按功能域组织,按需导入
  4. 一致性:统一的命名和参数设计