-
Notifications
You must be signed in to change notification settings - Fork 0
Util 包
omeyang edited this page Sep 17, 2026
·
1 revision
通用工具集。按 ADR-0007：util 包不内置可观测性（不引入 OTel/logger 依赖）。
| 包 | 用途 | 稳定性 | 覆盖率 |
|---|---|---|---|
| xfile | 文件操作（路径安全） | Stable | 96.9% |
| xid | Sonyflake v2 分布式 ID 生成 | Stable | 99.1% |
| xjson | JSON 格式化（PrettyE 等） | Stable | 100.0% |
| xkeylock | 基于 key 的进程内互斥锁（分片 channel） | Stable | 100.0% |
| xlru | LRU 缓存（泛型 + TTL） | Stable | 100.0% |
| xmac | MAC 地址工具（多格式解析、iter.Seq 迭代） |
Stable | 98.2% |
| xnet | IP 地址工具（net/netip + WireRange） | Stable | 98.4% |
| xpool | 泛型 Worker Pool | Stable | 100.0% |
| xproc | 进程信息查询（PID / 名称） | Stable | 100.0% |
| xsys | 系统资源限制（RLIMIT_NOFILE） | Stable | 96.0% |
| xutil | 泛型工具（If 三目运算等） | Stable | 100.0% |
| 场景 | 用 |
|---|---|
| 生成唯一 ID（分布式 + 时序） | xid |
| 按 key 互斥（同 key 互斥，不同 key 并发） | xkeylock |
| 进程内泛型缓存 | xlru |
| 并发任务池 | xpool |
| 解析 IP/CIDR/范围 | xnet |
| 解析 MAC 地址或区间迭代 | xmac |