GUID 生成

📖 节点概述

生成全局唯一标识符（GUID/UUID）。支持五种输出格式：标准 UUID4（随机）、UUID1（基于时间戳和 MAC 地址）、无连字符的大写/小写形式，以及将 UUID 转换为 128 位整数的纯数字字符串。每次调用都会产生一个新的唯一值。该节点为纯数据节点，无执行端口。

💡 使用场景：

• 数据库主键：为新增记录生成唯一 ID，避免主键冲突。
• 消息追踪 ID：在分布式系统中为每个请求分配唯一标识，用于日志关联和调试。
• 会话/令牌生成：生成临时 session ID 或一次性 token。
• 文件名去重：上传文件时使用 UUID 作为文件名，防止重名覆盖。
• 分布式 ID 生成：在高并发场景下生成不重复的标识符。

🎮 实战连线指南：如何正确使用它？

节点有一个下拉选择“类型”和一个输出端口 唯一标识符。直接使用输出值即可。

场景案例：生成随机 UUID4 作为用户 ID

1. 选择类型：下拉框选择 UUID4 (随机)。
2. 获取结果：唯一标识符 输出类似 "550e8400-e29b-41d4-a716-446655440000" 的字符串。
3. 后续使用：将标识符存入变量，用于数据库插入或日志记录。

无连字符大写示例：

• 类型：大写 (无连字符)
• 输出示例："550E8400E29B41D4A716446655440000"（32 个字符，全大写）

纯数字示例：

• 类型：纯数字 (128bit)
• 输出示例："113059446928150003120411430177456457408"（39 位十进制数字）

⚙️ 引脚与参数说明

📥 输入引脚

无数据输入端口。

⚙️ 控件参数

📤 输出引脚

🔧 生成算法说明

• UUID4：完全随机生成，基于随机数或伪随机数，碰撞概率极低。
• UUID1：基于 100 纳秒级时间戳和网卡 MAC 地址（若无可用 MAC 则随机替换），可能按时间有序，但隐私性较差。
• 无连字符形式：由 uuid.uuid4().hex 得到，不包含 -，长度为 32。
• 纯数字形式：通过 uuid.uuid4().int 获取 UUID 的整数表示，范围约 0 ~ 2^128-1。

⚠️ 注意事项

• 唯一性保证：UUID4 的碰撞概率极低（约 2^-122），可放心用于大多数场景。UUID1 如果时间回拨或 MAC 重复可能有极低碰撞风险。
• UUID1 的时间信息：UUID1 包含时间戳，可用于排序，但可能泄露创建时间，注意隐私。
• 纯数字长度：不同 UUID 的整数值可能有不同位数（最大约 39 位十进制数），下游节点应能处理大整数。
• 性能：生成 UUID 非常快，适合高频调用。
• 无执行端口：该节点是纯数据节点，无需触发信号，每次被下游读取时都会生成新的 UUID。如果需要固定一个 UUID 并在多处使用，请将其存入变量。

💎 小贴士：

• 无连字符格式常用于 URL 参数或文件名，避免非法字符。
• 纯数字格式可用于需要数值型 ID 的场景（如作为整数主键），但注意某些数据库的整数范围限制（如 MySQL 的 BIGINT 只有 64 位，无法容纳 128 位，需用字符串或两个字段存储）。
• 如果需要生成可排序的 ID（按时间递增），推荐使用 UUID1 或专门的雪花算法节点（如有）。
• 该节点每次调用都会生成新值，不会重复，因此可直接用于默认值或动态赋值。
• 由于是纯数据节点，无需执行信号，可在数据流中直接使用。