TwIdValidator

台灣身分證、統一編號、手機號碼驗證——三種證號自動辨識、詳細解析結果、假資料產生器。零依賴、線程安全。

立即安裝查看 GitHub

核心特色

🪪

三種證號全支援

本國人身分證、新式外來人口統一證號 (2021+)、舊式居留證號自動辨識,附性別與戶籍縣市解析。

🏢

統編新制檢核

完整支援財政部 2021 年 4 月新制 (5 的倍數) 與第 7 碼為 7 的特例雙取法。

📱

手機驗證＋正規化

嚴格 09 開頭 10 碼驗證;TryNormalize 處理 +886、空格、dash、括號與全形數字。

🧪

測試假資料產生器

產生檢核碼合法的樣本號碼,指定 seed 可重現;僅格式合法,不對應真實人物。

快速開始

1. 安裝套件

dotnet add package Ozakboy.TaiwanKit.TwIdValidator

2. 立即驗證

using Ozakboy.TaiwanKit.TwIdValidator;

TwId.IsValid("A123456789");          // true
TwBan.IsValid("04595257");           // true
TwPhone.IsValid("0912345678");       // true

TwIdResult r = TwId.Validate("A123456789");
// r.Kind → NationalId, r.Gender → Male, r.RegionName → "臺北市"

3. 正規化與假資料

// 正規化 +886 / 分隔符 / 全形數字
TwPhone.TryNormalize("+886-912-345-678", out string n);  // n = "0912345678"

// 產生檢核碼合法的測試假資料（不對應真實人物）
TwId.Generate(TwIdKind.NationalId, Gender.Female);
TwBan.Generate();