UUID v4 Generator

UUID v4 — наиболее широко используемая версия UUID в современном программном обеспечении. В отличие от своих аналогов, которые извлекают биты из временной метки или хэша пространства имён, UUID v4 построен полностью на случайных данных — что делает его простейшим и наиболее универсальным выбором, когда вам нужен уникальный идентификатор без каких-либо метаданных о его происхождении.

Этот генератор использует crypto.randomUUID() — нативный API браузера и Node.js, который получает энтропию из криптографически защищённого генератора случайных чисел операционной системы — того же источника, что используется для ключевого материала TLS.

Что такое UUID v4?

Universally Unique Identifier (UUID) — это 128-битная метка, стандартизированная в RFC 4122. Обычно она представляется в виде 32 шестнадцатеричных цифр, сгруппированных дефисами по шаблону 8-4-4-4-12:

В UUID v4 122 из 128 бит случайны. Оставшиеся 6 бит — фиксированные поля, предусмотренные спецификацией: 4 бита кодируют версию (0100 = 4) и 2 бита кодируют вариант RFC 4122 (10). Именно поэтому третья группа всегда начинается с 4, а четвёртая — с 8, 9, a или b.

Анатомия UUID v4

Разбор 550e8400-e29b-41d4-a716-446655440000:

UUID v4 и другие версии

RFC 4122 определяет пять версий UUID. Каждая решает свою задачу:

Когда использовать UUID v4

UUID v4 — правильный инструмент в подавляющем большинстве ситуаций, когда вам просто нужен «уникальный ID» без дополнительных ограничений:

Вероятность коллизии

При 122 случайных битах пространство UUID v4 содержит 2¹²² ≈ 5,3 × 10³⁶ возможных значений. Вероятность коллизии следует задаче о парадоксе дней рождения:

Широко известный ориентир: чтобы получить 50% вероятность одной коллизии, нужно сгенерировать примерно 2,71 × 10¹⁸ UUID. При скорости 1 миллиард UUID в секунду это займёт примерно 85 лет непрерывной генерации. Для любого реального приложения коллизии не являются практической проблемой.

Примеры кода

JavaScript — Браузер и Node.js 14.17+

Метод crypto.randomUUID() доступен нативно во всех современных браузерах (Chrome 92+, Firefox 95+, Safari 15.4+) и в Node.js 14.17+. Установка пакетов не требуется.

// Browser or Node.js 14.17+
const id = crypto.randomUUID()
// → "110e8400-e29b-41d4-a716-446655440000"

// Generate multiple
const ids = Array.from({ length: 5 }, () => crypto.randomUUID())

Node.js — более старые версии (пакет uuid)

const { v4: uuidv4 } = require('uuid')

const id = uuidv4()
// → "110e8400-e29b-41d4-a716-446655440000"

Python

import uuid

# Generate a UUID v4
id = str(uuid.uuid4())
# → '110e8400-e29b-41d4-a716-446655440000'

# The uuid module uses os.urandom() — cryptographically secure
print(uuid.uuid4().hex)  # without hyphens
# → '110e8400e29b41d4a716446655440000'

Go

import "github.com/google/uuid"

id := uuid.New().String()
// → "110e8400-e29b-41d4-a716-446655440000"

// Or using the standard library (Go 1.20+ with math/rand/v2 is NOT cryptographic)
// Always prefer github.com/google/uuid for production use

Rust

# Cargo.toml
[dependencies]
uuid = { version = "1", features = ["v4"] }

use uuid::Uuid;

let id = Uuid::new_v4().to_string();
// → "110e8400-e29b-41d4-a716-446655440000"

Часто задаваемые вопросы

const id = crypto.randomUUID()              // "550e8400-e29b-41d4-a716-446655440000"
const compact = id.replaceAll('-', '')     // "550e8400e29b41d4a716446655440000"