@litert/[email protected]

calendar Jul 7, 2025 · 1 min read · typescript uuid snowflake nodejs javascript  ·
分享到: linkedin copy

该文章根据 CC-BY-4.0 协议发表，转载请遵循该协议。
本文地址：https://fenying.net/project/litert/uuid/v2.0.0/

一个简单的 UUID 生成器工具库。

v2.0.0 Changes

  • feat(algo): 增加 UUIDv4 和 UUIDv5 算法的实现。
  • fix(algo): 标准 Snowflake ID 算法的实现现在支持自定义时间偏移量。
  • fix(algo): 修复了 Snowflake ID 算法在高并发情况下可能出现的重复 ID 问题。
  • fix(algo): 修复了 Snowflake-SI ID 算法在高并发情况下可能出现的重复 ID 问题。
  • fix(algo): 增加 Snowflake-SI ID 算法的自定义参数支持。
  • deprecate(algo): 废弃并移除 Snowflake-SI-vA 算法。
  • test(project): 增加完整的单元测试。
  • deprecate(deps): 移除了全部的运行时以来。

使用要求

  • TypeScript v5.0.0 (or newer)
  • Node.js v18.0.0 (or newer)

安装

通过 NPM 安装：

1npm i @litert/uuid --save

文档

生成算法

目前支持以下生成算法。

  • Snowflake

    一种 X (Twitter) 发明的 64 位整数 UUID 生成算法。

  • Snowflake-SI

    Snowflake-SI 是 Snowflake Safe Integer 的简写，即是 Snowflake 算法的简版，但是能 保证生成的是 ECMAScript 规范中的安全整数（0 ~ 2 ^ 54 - 1）

  • UUIDv4

    UUIDv4 是一种基于随机数生成的 UUID 生成算法。

  • UUIDv5

    UUIDv5 是一种基于 SHA-1 哈希算法的 UUID 生成算法，使用命名空间和名称作为输入。

示例

开源许可

该项目基于 Apache-2.0 开源协议授权。