ToolGood.Words 是一個基于 C# 實現的高性能非法詞（敏感詞）檢測組件，具備以下核心功能：

• ? 敏感詞過濾（支持通配符）
• ? 繁體/簡體互換
• ? 全角/半角互換
• ? 獲取拼音（全拼、首字母）
• ? 拼音模糊匹配
• ? 數字與中文大寫轉換

在 48k 敏感詞庫下，使用 StringSearchEx2.Replace 進行過濾，速度可超過 3 億字符/秒（測試環境：i7-8750H CPU）。

核心組件說明

非法詞（敏感詞）檢測類

常用方法

• ? SetKeywords：設置敏感詞庫
• ? ContainsAny：判斷是否包含敏感詞
• ? FindFirst：查找第一個敏感詞
• ? FindAll：查找所有敏感詞
• ? Replace：替換敏感詞為指定字符

示例代碼

var iwords = new StringSearch();
iwords.SetKeywords("中國|國人|zg人".Split('|'));

bool contains = iwords.ContainsAny("我是中國人"); // true
string replaced = iwords.Replace("我是中國人", '*'); // "我是***"

支持通配符的檢測類

示例代碼

var wordsSearch = new WordsMatch();
wordsSearch.SetKeywords(".[中美]國|國人|zg人".Split('|'));

var result = wordsSearch.FindFirst("我是中國人");
// result.Keyword => "是中國"
// result.MatchKeyword => ".[中美]國"

輔助功能

繁簡轉換與字符處理

WordsHelper.ToSimplifiedChinese("我愛中國"); // "我愛中國"
WordsHelper.ToTraditionalChinese("我愛中國"); // "我愛中國"
WordsHelper.ToSBC("abc"); // 全角：ａｂｃ
WordsHelper.ToDBC("ａｂｃ"); // 半角：abc

拼音處理

WordsHelper.GetPinyin("我愛中國"); // "WoAiZhongGuo"
WordsHelper.GetFirstPinyin("我愛中國"); // "WAZG"
WordsHelper.GetAllPinyin('傳'); // "Chuan,Zhuan"

數字與中文轉換

WordsHelper.ToChineseRMB(12345678901.12); // "壹佰貳拾叁億肆仟伍佰陸拾柒萬捌仟玖佰零壹元壹角貳分"
WordsHelper.ToNumber("壹佰貳拾叁億肆仟伍佰陸拾柒萬捌仟玖佰零壹元壹角貳分"); // 12345678901.12

拼音模糊匹配

使用 PinyinMatch 和 PinyinMatch<T> 可實現拼音模糊搜索，適用于地址、姓名等場景。

var match = new PinyinMatch();
match.SetKeywords("北京|天津|河北|遼寧|吉林|黑龍江|山東|江蘇|上海|浙江|安徽|福建|江西|廣東|廣西|海南|河南|湖南|湖北|山西|內蒙古|寧夏|青海|陜西|甘肅|新疆|四川|貴州|云南|重慶|西藏|香港|澳門|臺灣".Split('|').ToList());

var result = match.Find("BJ"); // ["北京"]

性能對比

在 10 萬次測試中，StringSearchEx2.ContainsAny 的性能遠超 C# 自帶正則表達式，效率是其 8.8 萬倍以上（與敏感詞數量相關）。

?? 注意：Regex.Matches 僅檢測出 11 個敏感詞，而 StringSearch 檢測出 14 個。

多語言實現

• ? Lua 版本：由 wenlifan 實現

開源地址

https://gitee.com/toolgood/ToolGood.Words?

··············  END  ··············