把加密、反射与 Excel 导出收进一个 C# 工具库（Masuit.Tools）

在 .NET 项目里写业务代码，字符串格式校验、时间戳互转、AES 加解密、Excel 导出这几类实现，几乎每个团队都要重复写一遍。Masuit.Tools 把这些常用封装收进一个 NuGet 包，大都是静态类，以扩展方法的形态挂在原生类型上，作者从 2017 年 3 月开始维护，官方说法是功能代码量不到 2MB。

Masuit.Tools 是用 C# 写的开源工具类库，把字符串校验、加密解密、文件图像处理、Excel 导出、硬件信息等封装整理成静态类，供 .NET 开发者直接调用。

它没有命令行入口，也没有独立的配置文件。开发者在代码里引用包，调用扩展方法拿返回值，或者把结果写进 FileStream、MemoryStream、HTTP 响应流。用它的主要是 .NET Framework 与 .NET Core 这条技术栈上的后端和桌面应用开发者。

第一次用它需要知道的事

仓库在 https://github.com/ldqk/Masuit.Tools，MIT 许可证，主要语言是 C#，语言占比 100%。截至抓取时点，Star 6188、Fork 1298、Watcher 147，开放 Issue 为 0。

• 选包先看目标框架。.NET Framework ≥ 4.6.2 用 Masuit.Tools.Net，.NET Core ≥ 2.1 用 Masuit.Tools.Core，只要基础功能用 Masuit.Tools.Abstraction。.NET Framework 4.5 只能装 Masuit.Tools.Net45，这个特供版相比 4.6.2 及 .NET Core 版本阉割了 Redis、HTML、文件压缩、ASP.NET 扩展、硬件监测、Session 扩展等功能。
• 官方建议的开发环境是 Windows 11 23H2 及以上、Visual Studio 2022 v17.8 及以上、.NET Core 2.1.0 及以上所有版本。
• 硬件监测这一类需要管理员权限，仅支持 Windows，部分函数仅支持物理机模式。
• 图像处理的底层依赖在 2026.2 版本从 ImageSharp 迁到了 SkiaSharp，原因是 ImageSharp 最新版本开始收费。
• 项目在 MIT 之外加了一条附加条款：违反劳动法的公司（非法裁员、超时用工、雇佣童工等）在诉讼中败诉且被发现的，作者有权追讨使用费或直接禁止使用；人力外包公司与 007 公司需要联系作者做商业授权，其他企业或个人按 MIT 随意使用不受限。

最短上手路径

1. 在 Visual Studio 的包管理器控制台执行 Install-Package Masuit.Tools.Core，.NET Framework 项目换成对应框架版本的包名。
2. 需要邮箱域名黑白名单校验的，在 appsettings.json 里加 EmailDomainWhiteList 与 EmailDomainBlockList 两个数组，元素是正则表达式；不需要就跳过这步。
3. 在 Startup 的构造函数里调用 configuration.AddToMasuitTools()。仓库里说明，不调用的话默认自动尝试加载 appsettings.json。
4. 在代码里调用扩展方法，例如 var (isMatch, match) = "[email protected]".MatchEmail();。
5. 判断结果直接来自返回值，需要落盘的就写进自己的文件流或响应流。

它实际上能做哪些事

字符串校验与数值转换

• 格式校验类扩展方法：MatchEmail() 返回 (isMatch, match) 元组，可配合 appsettings.json 里的域名黑白名单使用；MatchInetAddress() 匹配 IP 地址，MatchUrl() 匹配 URL，MatchPhoneNumber() 匹配手机号，MatchLandline() 匹配座机号，MatchIdentifyCard() 校验中国大陆身份证号，MatchCNPatentNumber() 校验中国专利申请号或专利号，MatchUSCC() 校验企业统一社会信用代码。仓库里没有说明这些方法对境外号码格式的支持情况。
• 进制转换：NumberFormater 内置 2 到 94 进制，也接受自定义字符集，官方举例说传入 1 万个字符那就支持一万进制。ToBase(36) 与 FromBase(36) 是扩展方法写法，FromBaseBig(16) 用来处理超大数字的转换，全部是纯数学运算。
• 中文数字输出：123.45.ToChineseMoney() 得到壹佰贰拾叁元肆角伍分，123.45.ToChineseNumber() 得到一百二十三点四五。

文本、图像与压缩

• HTML 防 XSS：HtmlSanitizerStandard() 按标准规则清理标签与属性，HtmlSanitizerCustom() 走自定义清理规则。
• 图像处理：覆盖图像裁剪、验证码、去边框（ImageBorderRemover）。2026.3.1 版本新增图片无损压缩，同时增强了 fileinfo.DetectFiletype、stream.GetImageType、fileinfo.IsImage 的图片格式检测。
• 压缩与文件类型探测：SevenZipCompressor 处理 7z 压缩包；DetectFiletype()、GetImageType()、IsImage() 用来判断真实文件类型，不只看扩展名。

集合、硬件与数据导出

• 集合扩展：支持把大 List 按份数或按每份固定数量切分，典型场景是数据库批量录入时元素太多影响拼接性能。
• 硬件监测：SystemInfo.CpuLoad、SystemInfo.PhysicalMemory、SystemInfo.GetCPUTemperature()、SystemInfo.GetMacAddress() 这类静态成员读取本机状态；CpuInfo.Locals、RamInfo.Local、DiskInfo.Locals、BiosInfo.Local 是快速读取写法。这部分需要管理员权限，仅支持 Windows。
• 自定义类型：LargeMemoryStream 最大支持 1TB 数据，官方推荐数据流大于 2GB 时使用；PooledMemoryStream 可内存复用；此外还有 DisposableDictionary、ConcurrentHashSet、ChineseCalendar、Clay / DynamicFactory、RadarChart、Circle、Sphere、MimeMapper、VersionNumber。
• Excel 导出：有独立的 Masuit.Tools.Excel 包，2026.3 版本新增 ToExcel 扩展方法，支持导出多表到 Excel。

参数速查

• configuration.AddToMasuitTools()：注册工具库用到的外部配置节。不调用时默认自动尝试加载 appsettings.json。
• EmailDomainWhiteList：邮箱校验白名单域名正则数组，不配置就不启用白名单。
• EmailDomainBlockList：邮箱校验黑名单域名正则数组，优先级高于白名单，不配置就不启用黑白名单。
• NumberFormater(36) 与 NumberFormater("0123456789abcdefghijklmnopqrstuvwxyz")：前者传进制数，后者传自定义字符集。
• 包选择：Masuit.Tools.Net、Masuit.Tools.Abstraction、Masuit.Tools.Core、Masuit.Tools.Net45、Masuit.Tools.AspNetCore、Masuit.Tools.Excel、Masuit.Tools.NoSQL.MongoDBClient。其中 AspNetCore 包包含 Core 的全部功能，并额外增加对 ASP.NET Core Web 的支持。
• 2026.3 版本给 HtmlDiff 新增了 maxUnchangedLength 参数，用于控制 diff 合并逻辑。

输出与结果位置

这个库不带命令行工具，也不生成报告目录，所有结果都通过方法返回值交给调用方。校验类方法返回 bool，邮箱校验返回 (isMatch, match) 元组，硬件信息返回 CpuInfo、RamInfo、DiskInfo、BiosInfo 这些对象。

Excel 导出的结果写进你传入的流或文件路径，仓库里没有说明存在默认输出位置。ASP.NET Core 包里的断点续传以 HTTP 响应形式返回给客户端。图像压缩、裁剪这类操作同样返回处理后的流或字节数组，落盘由调用方决定。

实际使用中的坑

• NuGet 装上 Masuit.Tools 后运行时报 Masuit.Tools.Abstractions 特定版本 dll 不存在。问题出现在 2.3.1.11 之后，反馈者推测是打包漏了 2.3.1.12 导致依赖文件版本错乱。状态：已解决。
• Linux 平台下 RSA 加密抛 System.PlatformNotSupportedException，同一份代码在 Windows 上正常，环境是 ASP.NET Core 2.1。状态：已解决。
• ReflectionUtil 里 (T)Expression.Lambda(callExpression, parameter).Compile() 每次调用都现场编译一次表达式，提出者实测比直接反射慢很多，提醒不要每次都调用。状态：已解决。
• SevenZipCompressor 解压由 7z 官方图形化工具压出来的 7z 包时抛异常。状态：已解决。

替代方案一览

下面两个项目与 Masuit.Tools 在选型上会碰到一起，对比维度按它们各自公开的仓库描述整理。

Masuit.Tools 的 Excel 导出是工具库里的一个子模块，围绕 ToExcel 这类扩展方法展开。如果你要的是模板化报表、复杂单元格样式与多格式导出，Magicodes.IE、ClosedXML.Report 这一类专做导入导出的库在深度上更合适。反过来，当需求同时散落在校验、加密、文件、硬件等好几类上时，为每一类各引一个专项库，依赖数量与升级维护成本都会上去。

别踩的合规线

硬件监测这一类会读到 CPU 序列号、硬盘序列号、网卡 MAC 地址和本机 IP 地址，属于设备标识信息。在自有资产上用来做授权绑定、资产盘点没有问题；部署到用户或员工的机器上采集，需要先取得明确授权，并把采集范围与用途讲清楚。这类功能还要求管理员权限，权限边界会随着功能一起放大，配置不当会让整台机器的信息暴露面变宽。

项目本身那条附加许可条款只约束违反劳动法的公司，普通企业或个人按 MIT 使用不受限制，但商业发行前仍建议确认自己的主体性质与使用方式。

什么时候值得用它

你的 .NET 项目里同时需要字符串校验、加解密、文件或图像处理、Excel 导出中的两类以上，引入一个包比分别引四五个专项库省事。

你更想要扩展方法的调用形式，让这些能力直接挂在原生类型上，不用调整现有的代码结构。

你跑在 .NET Framework 4.6.2 以上或 .NET Core 2.1 以上，并且硬件监测那部分只在 Windows 上使用。至于具体某个方法在 Linux 上的表现，仓库没有逐个标注，选型前最好先查一遍对应模块的说明。

焚评：这个项目的量化评分

本项目的选题来自 焚.com（一个按公开公式给 GitHub 项目打分的站）。焚评当前总分 9.5 分（满分 10）。下表是各维度的得分：

评分口径、权重与计算方式见焚.com 的评分方法页；数据随 GitHub 指标刷新，具体数值以焚.com 当前页面为准。本文正文为诀.com 独立撰写，评分数据由焚.com 授权引用。