本文提到的工具
邊閱讀邊在瀏覽器中開啟工具,立即試試整個流程。
什麼是 UUID?
UUID(Universally Unique Identifier,通用唯一識別碼) 是用來在電腦系統中識別資訊的 128 位元標籤。它由 RFC 4122 標準化(2024 年由 RFC 9562 更新),UUID 通常以下列標準格式書寫:

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 個位置(版本數字)是否與預期的版本號相符。
