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  ··············