前言
在當今數字化時代，數據的安全性和隱私性至關重要。隨著網絡應用的不斷發展，數字 ID 作為數據標識和訪問控制的關鍵元素，其保護顯得尤為重要。然而，傳統的數字 ID 往往直接暴露了一些敏感信息，如順序編號或數據庫主鍵ID，這不僅增加了數據泄露的風險，還可能讓不法分子有機可乘。
?在 .NET 中使用 Sqids 快速的為數字 ID 披上神秘短串，從而輕松隱藏敏感數字，保護數據安全。
Sqids 介紹
Sqids 是一個基于 C# 編寫、開源的輕量級工具庫，它允許你從數字生成類似 YouTube 的 ID。它可以將數字（如 127）編碼為字符串（如 yc3），然后你可以將這些字符串解碼回原始數字。當你想要將數字（如順序數值 ID）混淆為看似隨機的字符串，以便在 URL 和其他地方使用時，Sqids 就非常派得上用場。
功能特點
- Sqids 生成的 ID 是唯一的，并且始終可以解碼回原始數字。
- 可以將多個數字捆綁成一個 ID，然后可以將該 ID 解碼回相同的數字集。
- Sqids 生成的 ID 確保不包含常見的臟話，因此您可以在用戶可以看到的地方安全地使用這些 ID（例如在 URL 中）。
- .NET 7 及以上版本支持所有整數類型（如 int、long、byte、short 等），而舊版本僅支持 int。
- 采用基于 span 的優化實現，最小化內存分配并最大化性能。
創建一個控制臺應用
首先我們創建一個名為：SqidsExercise 的 .NET 9 控制臺應用：
安裝 Sqids NuGet 包
在 NuGet 包管理器中搜索 Sqids 安裝：
簡單使用示例
internal class Program
{
static void Main(string[] args)
{
// 使用默認選項創建 SqidsEncoder 實例
var sqids = new SqidsEncoder<int>();
// 編碼單個數字
var id = sqids.Encode(99);
Console.WriteLine($"編碼單個數字: {id}"); // 輸出：Q8P
// 解碼單個 ID
var number = sqids.Decode(id).Single();
Console.WriteLine($"解碼單個 ID '{id}': {number}"); // 輸出：99
// 編碼多個數字
var ids = sqids.Encode(7, 8, 9);
Console.WriteLine($"編碼多個數字 7, 8, 9: {ids}"); // 輸出：ylrR3H
// 解碼多個 ID
var numbers = sqids.Decode(ids);
Console.WriteLine($"解碼多個 ID '{ids}': {string.Join(", ", numbers)}"); // 輸出：7, 8, 9
// 使用自定義選項創建 SqidsEncoder 實例
var customSqids = new SqidsEncoder<int>(new SqidsOptions
{
Alphabet = "mTHivO7hx3RAbr1f586SwjNnK2lgpcUVuG09BCtekZdJ4DYFPaWoMLQEsXIqyz",//自定義字母表（注意：字母表至少需要 3 個字符）
MinLength = 5,//最小長度，默認情況下，Sqids 使用盡可能少的字符來編碼給定的數字。但是，如果你想讓你的所有 ID 至少達到一定的長度（例如，為了美觀），你可以通過 MinLength 選項進行配置：
BlockList = { "whatever", "else", "you", "want" } //自定義黑名單，Sqids 自帶一個大的默認黑名單，這將確保常見的詛咒詞等永遠不會出現在您的 ID 中。您可以像這樣向這個默認黑名單添加額外項：
});
// 使用自定義 SqidsEncoder 編碼和解碼
var customId = customSqids.Encode(8899);
Console.WriteLine($"使用自定義 SqidsEncoder 編碼: {customId}"); // 輸出：i1uYg
var customNumber = customSqids.Decode(customId).Single();
Console.WriteLine($"使用自定義 SqidsEncoder 解碼: {customNumber}"); // 輸出：8899
}
}
項目源碼地址
更多項目實用功能和特性歡迎前往項目開源地址查看??，別忘了給項目一個Star支持??。
轉自https://www.cnblogs.com/Can-daydayup/p/18867416
該文章在 2025/5/9 8:55:51 編輯過
400 186 1886
