Генератор UUID
Профессиональный инструмент для генерации и валидации UUID, поддерживающий несколько версий: v1 (на основе временной метки), v4 (случайный), v5 (на основе имени) и v7 (Unix-время + случайные данные). Предлагает пакетную генерацию с настраиваемым количеством, гибкие параметры форматирования, включая преобразование в верхний регистр, удаление дефисов и добавление фигурных скобок. Включает встроенный валидатор UUID с определением версии и примеры кода на нескольких языках программирования. Подходит для идентификации записей в базах данных, трассировки логов, межсистемных интерфейсов и других сценариев. Все операции выполняются локально в браузере, что гарантирует конфиденциальность и безопасность.
Руководство по использованию
Функции
- Поддержка UUID версий 1, 4, 5 и 7
- Пакетная генерация с настраиваемым количеством
- Гибкое форматирование: верхний регистр, удаление дефисов, добавление фигурных скобок
- Встроенный валидатор с автоматическим определением версии
- Полная интернационализация и поддержка нескольких тем
Что такое UUID?
UUID — это 128-битные идентификаторы, обычно представляемые как строки из 36 символов с дефисами.
UUID v1: основан на временной метке и MAC-адресе; упорядочен по времени, но может раскрывать информацию о времени или местоположении.
UUID v4: Генерируется случайным образом; наиболее распространённый вариант, обеспечивающий высокую уникальность и конфиденциальность.
UUID v7: Основан на миллисекундах Unix + случайных битах; естественно сортируемый и лишён проблем с приватностью, характерных для v1.
UUID v5: Детерминированно генерируется из UUID пространства имён и имени с использованием SHA-1; одинаковые входные данные всегда дают одинаковый результат.
UUID Типичные сценарии использования
- Уникальные идентификаторы для записей в базе данных или ресурсов
- Trace ID для логирования и трассировки событий
- Непредсказуемые публичные идентификаторы
- Согласованные идентификаторы при интеграции систем
UUID Частые вопросы и подводные камни
- v1 и конфиденциальность: версия v1 может раскрывать временные метки или местоположение оборудования; для задач, чувствительных к приватности, предпочтительнее использовать v4.
- Чувствительность к регистру: сравнение UUID не зависит от регистра.
- Дефисы нужны только для читаемости; сохраняйте их, если это не противоречит требованиям устаревших систем.
- Формат в фигурных скобках (например, {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}) поддерживается в некоторых средах (например, в реестре Windows).
- v5 детерминирована: одинаковое пространство имён + имя => одинаковый UUID. Идеально подходит для идемпотентных операций; избегайте использования там, где требуется непредсказуемость.
Использование UUID в языках программирования
// 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 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
// 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();
<?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
import uuid
# v4
uid = uuid.uuid4()
# v1
uid1 = uuid.uuid1()
# 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 get github.com/google/uuid
import "github.com/google/uuid"
id := uuid.New() // v4
id1 := uuid.NewUUID() // v1 (may return error)
// 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
// 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
// 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();
import java.util.UUID;
UUID id = UUID.randomUUID(); // v4
// 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 */ }