UUID 生成工具

生成与验证 UUID(v1、v4、v5、v7),支持批量和多种格式化选项,并提供多语言代码示例。

UUID 生成器

格式选项

UUID 验证器

使用说明

UUID 是 128 位标识符,标准表示为包含连字符的 36 个字符。
UUID v1:基于时间戳与网卡信息,时间有序,但可能泄露时间/位置。
UUID v4:基于随机数,最常用,具有较好的唯一性与隐私性。
UUID v7:基于 Unix 毫秒时间 + 随机数,天然可排序,同时避免 v1 的隐私问题。
UUID v5:基于命名空间 UUID 与名称,通过 SHA-1 计算;相同输入生成结果确定。
标准格式:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx(36 个字符)。

功能特性

  • 支持 UUID v1、v4、v5、v7
  • 支持自定义数量的批量生成
  • 灵活格式化:大写、去连字符、加大括号
  • 内置验证器与版本识别
  • 完整的国际化与多主题支持

什么是 UUID

UUID 是 128 位标识符,标准表示为包含连字符的 36 个字符。

UUID v1:基于时间戳与网卡信息,时间有序,但可能泄露时间/位置。

UUID v4:基于随机数,最常用,具有较好的唯一性与隐私性。

UUID v7:基于 Unix 毫秒时间 + 随机数,天然可排序,同时避免 v1 的隐私问题。

UUID v5:基于命名空间 UUID 与名称,通过 SHA-1 计算;相同输入生成结果确定。

UUID 快速示例

标准格式:
550e8400-e29b-41d4-a716-446655440000
大写格式:
550E8400-E29B-41D4-A716-446655440000
无连字符:
550e8400e29b41d4a716446655440000
带大括号:
{550e8400-e29b-41d4-a716-446655440000}

UUID 常见用途

  • 数据库记录或资源的唯一标识
  • 日志与事件追踪的 Trace ID
  • 不易猜测的公开标识
  • 跨系统接口中的统一标识

UUID 常见问题与坑

  • v1 与隐私:v1 可能泄露时间/位置,注重隐私时建议用 v4。
  • 大小写是否等价:匹配时大小写不敏感
  • 连字符仅为表示用;除非受限,一般建议保留
  • 大括号形式在某些环境可接受(如 Windows 注册表)
  • v5 具有确定性(相同命名空间 + 名称 => 相同 UUID)。适合幂等场景;不适合需要不可预测性的场景。

如何在编程语言中使用 UUID

JavaScript
生成
// UUID v4 (simple)
function uuidv4(){
  return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, c => {
    const r = Math.random()*16|0, v = c === 'x' ? r : (r&0x3|0x8);
    return v.toString(16);
  });
}
const id = uuidv4();
UUID v7(Unix 时间 + 随机)
// UUID v7 (Unix ms + randomness)
function uuidv7(){
  const cryptoObj = (globalThis.crypto || globalThis.msCrypto);
  const rb = n => { const a = new Uint8Array(n); cryptoObj?.getRandomValues ? cryptoObj.getRandomValues(a) : a.forEach((_,i)=>a[i]=Math.random()*256|0); return a; };
  const hex = b => Array.from(b).map(x=>x.toString(16).padStart(2,'0')).join('');
  const ts = BigInt(Date.now()).toString(16).padStart(12,'0');
  const ver = rb(2); ver[0] = (ver[0] & 0x0f) | 0x70;    // set version 7
  const vrn = rb(2); vrn[0] = (vrn[0] & 0x3f) | 0x80;    // RFC4122 variant
  const tail = rb(6);
  return `${ts.slice(0,8)}-${ts.slice(8,12)}-${hex(ver)}-${hex(vrn)}-${hex(tail)}`;
}
const id7 = uuidv7();
验证
const re=/^[0-9a-f]{8}-[0-9a-f]{4}-[1-57][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
re.test(id); // true/false
PHP
生成
<?php
// v4 using random_bytes
function uuidv4(){
  $data = random_bytes(16);
  $data[6] = chr((ord($data[6]) & 0x0f) | 0x40);
  $data[8] = chr((ord($data[8]) & 0x3f) | 0x80);
  return vsprintf('%s%s-%s-%s-%s-%s%s%s', str_split(bin2hex($data), 4));
}
$id = uuidv4();
UUID v7(Unix 时间 + 随机)
<?php
// composer require ramsey/uuid:^4.7
use Ramsey\Uuid\Uuid;

$uuid7 = Uuid::uuid7();
验证
<?php
$re = '/^[0-9a-f]{8}-[0-9a-f]{4}-[1-57][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i';
preg_match($re, $id) === 1; // true/false
Python
生成
import uuid
# v4
uid = uuid.uuid4()
# v1
uid1 = uuid.uuid1()
UUID v7(Unix 时间 + 随机)
# pip install uuid6
from uuid6 import uuid7

uid7 = uuid7()
验证
import re
re_uuid = re.compile(r'^[0-9a-f]{8}-[0-9a-f]{4}-[1-57][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$', re.I)
bool(re_uuid.match(str(uid)))
Go
生成
// go get github.com/google/uuid
import "github.com/google/uuid"

id := uuid.New()     // v4
id1 := uuid.NewUUID() // v1 (may return error)
UUID v7(Unix 时间 + 随机)
// go get github.com/gofrs/uuid/v5
import (
  uuid "github.com/gofrs/uuid/v5"
)

id7, err := uuid.NewV7()
验证
import "github.com/google/uuid"
_, err := uuid.Parse(id.String()) // err == nil means valid
Rust
生成
// Cargo.toml: uuid = { version = "1", features = ["v4", "v1"] }
use uuid::Uuid;

let v4 = Uuid::new_v4();
// v1 requires a context/ts, often via external crate; shown for completeness
UUID v7(Unix 时间 + 随机)
// Cargo.toml: uuid = { version = "1", features = ["v7"] }
use uuid::Uuid;

let v7 = Uuid::now_v7();
验证
use uuid::Uuid;
let ok = Uuid::parse_str(v4.to_string().as_str()).is_ok();
Java
生成
import java.util.UUID;

UUID id = UUID.randomUUID(); // v4
UUID v7(Unix 时间 + 随机)
// Maven: com.github.f4b6a3:uuid-creator
import com.github.f4b6a3.uuid.UuidCreator;

UUID v7 = UuidCreator.getTimeOrderedEpoch(); // UUIDv7
验证
import java.util.UUID;

try { UUID.fromString(id.toString()); /* valid */ } catch (IllegalArgumentException ex) { /* invalid */ }