什麼是 UUID?

UUID(Universally Unique Identifier,通用唯一識別碼) 是用來在電腦系統中識別資訊的 128 位元標籤。它由 RFC 4122 標準化(2024 年由 RFC 9562 更新),UUID 通常以下列標準格式書寫:

UUID 完整指南:版本、使用情境,以及如何在 v4 與 v7 之間選擇

550e8400-e29b-41d4-a716-446655440000

先是八個十六進位字元,再接四、四、四、十二個字元的群組,永遠是 32 個十六進位數字加上四個連字號,共 36 個字元。

UUID 的基本承諾是:您可以在任何機器、任何時間產生一個,且與歷來產生過的其他任何 UUID 發生碰撞的機率低到天文數字等級。這使它在無法與中央 ID 管理機構協調的分散式系統中極具價值。


版本完整參考

UUID 規格定義了多個版本,各自有不同的產生策略。

版本 產生策略 可排序 使用時機
v1 MAC 位址 + 時間戳記 部分 舊系統、稽核軌跡
v2 DCE 安全性(POSIX UID/GID) 否 幾乎不會用到
v3 命名空間 + 名稱的 MD5 雜湊 否 由已知輸入產生確定性 ID(舊式)
v4 隨機 否 一般用途、工作階段 ID
v5 命名空間 + 名稱的 SHA-1 雜湊 否 由已知輸入產生確定性 ID
v6 時間戳記 + 隨機(重新排列的 v1) 是 v1 的可排序替代品
v7 Unix 毫秒時間戳記 + 隨機 是 資料庫主鍵(建議)
v8 自訂版面配置 不一定 特定應用程式專用的格式

版本 1:MAC 位址 + 時間戳記

UUID v1 會編入產生該 UUID 的機器的 MAC 位址,以及 100 奈秒的時間戳記。由於機器身分與時間的組合是唯一的,碰撞風險極低。

缺點:MAC 位址可以識別個人。在網頁應用程式中產生 v1 UUID,可能無意間洩漏伺服器硬體的細節。因此,新系統已大多不再採用 v1。

版本 3 與版本 5:確定性 UUID

v3 與 v5 都是以雜湊函式(v3 用 MD5,v5 用 SHA-1),由一個命名空間 UUID 與一個名稱字串產生 UUID。只要輸入相同,就永遠得到相同的 UUID。

這對於由外部資料建立穩定的識別碼很有用:

// v5 範例:同一個 URL 永遠產生同一個 UUID
// URL 的命名空間 UUID 定義於 RFC 4122
const DNS_NAMESPACE = '6ba7b810-9dad-11d1-80b4-00c04fd430c8';
uuidv5('example.com', DNS_NAMESPACE); // 結果永遠相同

可以的話,請用 v5 而非 v3:SHA-1 比 MD5 強,但在新設計中,兩者都不適合用於密碼學用途。

版本 4:主力

UUID v4 就是 122 位元密碼學安全的隨機資料(其餘 6 位元編入版本與變體)。它是目前世界上產生最多的 UUID 類型。

// 瀏覽器 / Node.js(內建,不需要函式庫)
const id = crypto.randomUUID(); // "f47ac10b-58cc-4372-a567-0e02b2c3d479"

// Python
import uuid
print(uuid.uuid4())  # 3d6f4890-4f40-4d09-aa11-3efb...

// Go
import "github.com/google/uuid"
id := uuid.New()

碰撞機率: 如果每秒產生 10 億個 v4 UUID,持續 86 年,發生一次碰撞的機率大約是 50%。就實務而言,碰撞幾乎不可能發生。

限制: v4 UUID 是隨機的,因此無法排序。把隨機的 UUID 當作主鍵插入 B-tree 索引,隨著時間推移會造成索引碎片化,在大規模時損害寫入效能。

版本 7:現代標準

UUID v7 於 RFC 9562(2024 年 5 月)標準化。它把 Unix 毫秒時間戳記放在最高有效位元,後面接隨機資料。

 0                   1                   2                   3
 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                           unix_ts_ms                          |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|          unix_ts_ms           |  ver  |       rand_a          |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|var|                        rand_b                             |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                            rand_b                             |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

由於時間戳記在高位元,v7 UUID 可以依產生時間做字典序排序。依序產生的兩個 UUID 會依該順序排列,正是資料庫索引想要的。

// 使用 'uuidv7' 套件
import { uuidv7 } from 'uuidv7';

const id1 = uuidv7(); // "018e1f27-42a0-7000-8000-..."
const id2 = uuidv7(); // "018e1f27-42a1-7000-..."
// id1 < id2(字串比較也能得到正確順序)

UUID 與循序整數 ID

作為資料庫主鍵,傳統的選擇是自動遞增的整數(SERIAL、AUTO_INCREMENT)。UUID 改變了這個取捨。

考量 自動遞增整數 UUID v4 UUID v7
ID 可預測性 可猜測(可列舉) 無法預測 無法預測
索引效能 極佳(循序) 差(隨機寫入) 極佳(依時間排序)
分散式產生 需要中央協調者 任何節點、任何時間 任何節點、任何時間
合併/複寫 複雜 簡單 簡單
每列的額外空間 4–8 位元組 16 位元組 16 位元組
人類可讀性 容易 困難 困難

對大多數現代系統,尤其是執行微服務、處理多區域部署,或合併多個來源資料的系統,UUID v7 是主鍵的正確預設選擇。


在常用語言中產生 UUID

JavaScript / TypeScript

// v4 — 內建於現代瀏覽器與 Node.js 14.17+
const sessionId = crypto.randomUUID();

// v7 — 安裝 uuidv7 套件
import { uuidv7 } from 'uuidv7';
const recordId = uuidv7();

Python

import uuid

# v4
print(uuid.uuid4())

# v7 — 在 Python 3.12+ 可透過第三方函式庫使用
# pip install uuid7
from uuid7 import uuid7
print(uuid7())

Go

import "github.com/google/uuid"

// v4
id := uuid.New()

// v7
id, err := uuid.NewV7()

PostgreSQL

-- v4 內建(需要 pgcrypto 或 pg 13+)
SELECT gen_random_uuid();

-- 以 pgx 或應用程式端產生 v7
INSERT INTO users (id, email) VALUES ($1, $2)
-- 由應用程式層傳入 uuidv7()

實務上的考量

在資料庫中儲存 UUID

  • PostgreSQL:使用原生的 UUID 型別。以 16 位元組儲存,而不是 36 個字元的字串。
  • MySQL/MariaDB:為了效率使用 BINARY(16),為了可讀性則用 CHAR(36)。以 UUID_TO_BIN(uuid, true) 插入,以保留可排序性。
  • SQLite:以 BLOB(16) 或 TEXT(36) 儲存。

字串與二進位儲存

以文字字串("f47ac10b-58cc-4372-a567-0e02b2c3d479")儲存的 UUID 會佔用 36 位元組;以原始二進位儲存則是 16 位元組。在數百萬列的規模下,這個差異對儲存空間與索引大小都很可觀。

對 URL 安全的 UUID

標準 UUID 只含十六進位數字與連字號,因此對 URL 是安全的。不過,如果您想在 URL 中使用更精簡的表示法,可以移除連字號(32 個字元),或使用 Base64Url 編碼(22 個字元)。


2026 年 11 月新增的功能

  • 現在可產生 NanoID(自訂字元與長度、無偏差、附碰撞機率估計)、KSUID(可讀取時間)與以時間為基礎的 UUID v1 / v6。
  • v1 / v6 的節點為隨機值(含多點傳播位元),不會使用 MAC 位址。v6 以字串排序即為時間順序,適合作為資料庫主鍵。

在工具中試用

常見問題

UUID v4 真的是隨機的嗎?

UUID v4 使用 122 位元的隨機資料(其餘 6 位元固定用於版本與變體)。是否「真正」隨機,取決於亂數產生器。大多數現代環境使用密碼學安全的偽隨機數產生器(CSPRNG),適合用在對安全敏感的用途。瀏覽器與 Node.js 中的 crypto.randomUUID() 使用的是系統的 CSPRNG。

我應該把現有的 v4 UUID 全部改成 v7 嗎?

不需要,遷移既有 ID 通常不值得花這個力氣。v7 的好處(可排序、索引的區域性)只適用於新的插入。如果您的系統已經有 v4 UUID,且索引效能可以接受,就保持原樣。從新的資料表或新系統開始使用 v7 即可。

兩台機器會產生相同的 UUID v4 嗎?

理論上會,實際上不會。有 122 位元的隨機性,要達到 50% 的碰撞機率,需要產生約 2.7 × 10¹⁸ 個 UUID。即使全世界所有機器合計每秒產生 10 億個,也需要超過 85 年。

什麼是 nil UUID?

nil UUID 全為零:00000000-0000-0000-0000-000000000000。它被用作哨兵值(類似 null),表示「沒有 UUID」。有些 ORM 會在指派 ID 之前,把它當作預設值。

如何驗證 UUID 的格式?

用簡單的正規表達式檢查:

const UUID_REGEX =
  /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;

UUID_REGEX.test('550e8400-e29b-41d4-a716-446655440000'); // true
UUID_REGEX.test('not-a-uuid'); // false

若要依版本驗證,請檢查第 14 個位置(版本數字)是否與預期的版本號相符。