作为.NET开发者日常开发中总会遇到各种重复的基础功能开发——JSON序列化、数据类型转换、HTTP请求封装、Excel处理...这些功能看似简单但要做到稳定、高效、易用却需要不少精力。今天给大家推荐一款功能丰富的.NET工具类库「Acme」覆盖11大核心模块让你告别重复造轮子专注业务逻辑开发。一、Acme 工具库简介Acme 是一款面向.NET 8.0 框架的通用工具类库当前版本5.6.4支持.NET 8.0/9.0/10.0全版本旨在封装日常开发中高频使用的功能模块提供简洁、易用、高性能的API降低开发成本。核心特点 开箱即用NuGet一键安装几行代码完成集成 场景全覆盖JSON、类型转换、HTTP、加密、Excel等11大核心模块 性能优化内置异步支持、缓存策略等性能优化方案 安全可靠内置输入验证、安全加密等最佳实践 完善文档每个功能都有详细示例和最佳实践指导二、快速上手5分钟集成使用1. 安装方式NuGet安装推荐dotnet add package Acme手动集成将Acme项目添加到解决方案在目标项目中添加项目引用即可。2. 服务注册在Program.cs中完成服务注册ASP.NET Core项目using Acme; var builder WebApplication.CreateBuilder(args); // 注册Acme核心服务 builder.Services.AddAcmeBuilderServer(); var app builder.Build();3. 极简使用示例using Acme.Tools; public class HomeController : Controller { public IActionResult Index() { // JSON序列化 var user new { Name 张三, Age 25 }; string json user.ToJson(); // 安全类型转换 int number 123.ToInt(); // MD5加密 string hashedPassword MD5Encryption.Encrypt(password123); return View(); } }三、核心功能模块详解1. JSON处理Json.cs基于Newtonsoft.Json封装提供简洁的序列化/反序列化API// 对象转JSON var user new { Name 张三, Age 25 }; string json user.ToJson(); // JSON转实体 string jsonStr {\Name\:\李四\,\Age\:30}; User user jsonStr.ToEntityUser(); // 动态类型解析 dynamic dynamicUser jsonStr.ToEntitydynamic(); Console.WriteLine(dynamicUser.Name); // 输出李四2. 数据类型转换ConvHelper.cs解决.NET原生类型转换繁琐、易出错的问题// 安全类型转换带默认值 int safeNum abc.ToInt(0); // 转换失败返回默认值0 double price 99.9.ToDouble(); bool isTrue true.ToBool(); // 路径处理 string webPath C:\files\image.jpg.ToUrlPath(); // 输出/files/image.jpg // 时间戳处理 long timestamp ConvHelper.GetTimeStamp(); // 13位时间戳 DateTime date ConvHelper.GetDateTimeFromTimestamp(timestamp); // 随机码生成 string verifyCode 0-9.ToRandomCode(6); // 6位数字验证码3. HTTP请求封装HttpHelper.cs简化HttpClient使用内置JSON支持和错误处理// GET请求 string response HttpHelper.HttpClientGet(https://api.example.com/users?id1); // POST请求自动序列化JSON var postData new { UserId 1, Name 新名称 }; string postResp HttpHelper.HttpClientPost(https://api.example.com/update, postData); // 带请求头的请求 var headers new Dictionarystring, string { { Authorization, Bearer your-token }, { Content-Type, application/json } }; string authResp HttpHelper.HttpClientGet(https://api.example.com/protected, headers);4. 加密工具MD5Encryption.cs适用于非敏感数据的MD5加密支持大小写输出// 基础加密 string password 123456; string md5Lower MD5Encryption.Encrypt(password); // 小写 string md5Upper MD5Encryption.Encrypt(password, true); // 大写 // 密码验证 bool isValid MD5Encryption.Compare(inputPwd, storedHash);⚠️ 注意MD5适用于非敏感数据用户密码等敏感信息建议使用BCrypt/Argon2算法5. Session/Cookie管理提供统一的Session/Cookie操作接口支持对象存储// Session操作 public class AccountController : Controller { private readonly IHttpSessionService _sessionService; public AccountController(IHttpSessionService sessionService) { _sessionService sessionService; } public IActionResult Login(string username) { // 存储字符串 _sessionService.SetSession(CurrentUser, username); // 存储对象 var userInfo new { Name username, Role Admin }; _sessionService.SetObjectAsJson(UserInfo, userInfo); return RedirectToAction(Index); } } // Cookie操作 _cookieService.SetCookies(AuthToken, abc123, 60); // 60分钟过期 string token _cookieService.GetCookies(AuthToken); _cookieService.DeleteCookies(AuthToken);6. 拼音处理Pinyin.cs中文转拼音首字母适用于搜索、排序场景// 中文转拼音首字母 string initials Pinyin.GetInitials(中文拼音处理); // 输出ZWPYCL // 搜索场景示例 public ListUser SearchUsers(string keyword) { string pinyinKey Pinyin.GetInitials(keyword).ToLower(); return _userRepo.SearchByPinyinKey(pinyinKey); }7. Excel处理基于NPOI支持Excel导入导出自动映射实体类// 定义数据模型 public class Product { public string Name { get; set; } public decimal Price { get; set; } public int Stock { get; set; } } // 导出Excel public void ExportProducts(ListProduct products) { var excelService new NpolExcelServiceProduct(); // 自定义表头映射 var headers new Dictionarystring, string { { Name, 产品名称 }, { Price, 价格 }, { Stock, 库存 } }; excelService.ExportToExcel(products, products.xlsx, 产品列表, headers); } // 导入Excel public ListProduct ImportProducts(string filePath) { var excelService new NpolExcelServiceProduct(); return excelService.ImportFromExcel(filePath); }8. 其他核心模块模块功能亮点适用场景验证码生成VerCode.cs生成指定长度数字验证码手机/邮箱验证码、交易验证验证工具VerificationHelper.csGuid验证、正则验证邮箱/手机号/身份证输入验证、数据校验配置管理统一读取appsettings.json、自定义JSON配置配置集中管理、多环境配置四、最佳实践指南1. 依赖注入最佳实践合理设置服务生命周期避免内存泄漏// Scoped每个请求一个实例用户服务、业务服务 builder.Services.AddScopedIUserService, UserService(); // Transient每次注入新实例工具类、临时服务 builder.Services.AddTransientIExcelService, ExcelService(); // Singleton全局单例缓存服务、配置服务 builder.Services.AddSingletonICacheService, CacheService();2. 错误处理策略// 安全数据处理封装 public class SafeDataProcessor { public int? SafeConvertToInt(string input) { try { return input.ToInt(); } catch { return null; } } public T SafeJsonDeserializeT(string json) where T : new() { try { return json.ToEntityT(); } catch { return new T(); } } } // 全局异常处理 app.UseExceptionHandler(options { options.Run(async context { var exception context.Features.GetIExceptionHandlerFeature(); if (exception ! null) { // 记录日志 Console.WriteLine($全局异常{exception.Error.Message}); // 返回友好响应 context.Response.StatusCode 500; await context.Response.WriteAsJsonAsync(new { success false, message 服务器处理失败请稍后重试 }); } }); });3. 性能优化建议缓存策略public class CachedUserService : IUserService { private readonly IUserService _userService; private readonly ICacheService _cacheService; public async TaskUser GetUserById(int id) { string cacheKey $User:{id}; // 优先从缓存获取 var cachedUser _cacheService.GetUser(cacheKey); if (cachedUser ! null) return cachedUser; // 缓存未命中从数据库获取 var user await _userService.GetUserById(id); // 存入缓存10分钟过期 _cacheService.Set(cacheKey, user, TimeSpan.FromMinutes(10)); return user; } }异步操作// 控制器异步示例 [HttpGet({id})] public async TaskIActionResult GetUser(int id) { try { var user await _userService.GetUserById(id); return Ok(user); } catch (Exception ex) { return BadRequest(new { message ex.Message }); } }4. 安全最佳实践密码安全处理加盐MD5public string HashPassword(string password) { // 生成8位盐值 string salt Guid.NewGuid().ToString().Substring(0, 8); // 密码盐值加密 return MD5Encryption.Encrypt(password salt) : salt; } // 密码验证 public bool VerifyPassword(string inputPwd, string storedHash) { var parts storedHash.Split(:); if (parts.Length ! 2) return false; string hash parts[0]; string salt parts[1]; return MD5Encryption.Encrypt(inputPwd salt) hash; }输入验证// 常用验证正则 public static class ValidationPatterns { public const string Email ^[\w-](\.[\w-])*[\w-](\.[\w-])$; public const string Phone ^1[3-9]\d{9}$; public const string IdCard ^[1-9]\d{5}(18|19|20)\d{2}(0[1-9]|1[0-2])(0[1-9]|[12]\d|3[01])\d{3}[\dXx]$; } // 验证逻辑 public bool ValidateUser(User user) { if (user.Id.IsDefault()) return false; if (!user.Email.RegexVerification(ValidationPatterns.Email)) return false; if (!user.Phone.RegexVerification(ValidationPatterns.Phone)) return false; return true; }五、依赖与兼容性核心依赖包依赖包用途推荐版本Newtonsoft.JsonJSON序列化13.0.4NPOIExcel操作2.7.5Microsoft.Extensions.DependencyInjection依赖注入9.0.11.NET8/9、10.0.3.NET10Microsoft.Extensions.Caching.Abstractions缓存抽象9.0.11.NET8/9、10.0.3.NET10版本兼容性✅ .NET 8.0完全支持✅ .NET 9.0完全支持✅ .NET 10.0完全支持六、常见问题排查1. 配置文件读取失败检查appsettings.json是否存在于项目根目录确认配置项路径正确如ConnectionStrings:DefaultConnection验证JSON格式是否合法2. Excel导入失败确认安装NPOI包dotnet add package NPOI检查Excel文件格式是否正确.xlsx/.xls验证实体类属性与Excel列名映射是否一致确保应用程序有文件读取权限3. 依赖注入报错确认已调用builder.Services.AddAcmeBuilderServer()检查服务生命周期是否正确避免Singleton注入Scoped验证接口与实现类是否正确注册七、总结Acme .NET工具类库通过封装日常开发中的高频功能帮助开发者减少重复代码提升开发效率。无论是小型项目快速开发还是大型项目的基础组件建设Acme都能提供可靠的支持。核心优势回顾 开箱即用NuGet一键安装快速集成 功能全面11大核心模块覆盖绝大部分开发场景 性能优异内置异步、缓存等性能优化方案 安全可靠遵循安全开发最佳实践 易于维护完善的文档和示例降低维护成本如果你正在寻找一款能解决.NET开发中各种琐碎问题的工具库Acme绝对值得一试。无论是新手入门还是资深开发者提升效率都能从中受益。技术支持 邮箱支持yzxs949163.com 文档地址Acme官方文档 问题反馈发邮件提供截图和详细报错以及Acme版本、.NET版本、完整错误信息和重现步骤最后技术的价值在于解决问题Acme工具库的设计理念就是让开发者把更多精力放在业务逻辑上而非重复的基础功能开发。希望这款工具库能成为你.NET开发路上的好帮手
Acme .NET 工具类库：一站式解决.NET开发高频场景问题
发布时间：2026/5/19 12:52:18
作为.NET开发者日常开发中总会遇到各种重复的基础功能开发——JSON序列化、数据类型转换、HTTP请求封装、Excel处理...这些功能看似简单但要做到稳定、高效、易用却需要不少精力。今天给大家推荐一款功能丰富的.NET工具类库「Acme」覆盖11大核心模块让你告别重复造轮子专注业务逻辑开发。一、Acme 工具库简介Acme 是一款面向.NET 8.0 框架的通用工具类库当前版本5.6.4支持.NET 8.0/9.0/10.0全版本旨在封装日常开发中高频使用的功能模块提供简洁、易用、高性能的API降低开发成本。核心特点 开箱即用NuGet一键安装几行代码完成集成 场景全覆盖JSON、类型转换、HTTP、加密、Excel等11大核心模块 性能优化内置异步支持、缓存策略等性能优化方案 安全可靠内置输入验证、安全加密等最佳实践 完善文档每个功能都有详细示例和最佳实践指导二、快速上手5分钟集成使用1. 安装方式NuGet安装推荐dotnet add package Acme手动集成将Acme项目添加到解决方案在目标项目中添加项目引用即可。2. 服务注册在Program.cs中完成服务注册ASP.NET Core项目using Acme; var builder WebApplication.CreateBuilder(args); // 注册Acme核心服务 builder.Services.AddAcmeBuilderServer(); var app builder.Build();3. 极简使用示例using Acme.Tools; public class HomeController : Controller { public IActionResult Index() { // JSON序列化 var user new { Name 张三, Age 25 }; string json user.ToJson(); // 安全类型转换 int number 123.ToInt(); // MD5加密 string hashedPassword MD5Encryption.Encrypt(password123); return View(); } }三、核心功能模块详解1. JSON处理Json.cs基于Newtonsoft.Json封装提供简洁的序列化/反序列化API// 对象转JSON var user new { Name 张三, Age 25 }; string json user.ToJson(); // JSON转实体 string jsonStr {\Name\:\李四\,\Age\:30}; User user jsonStr.ToEntityUser(); // 动态类型解析 dynamic dynamicUser jsonStr.ToEntitydynamic(); Console.WriteLine(dynamicUser.Name); // 输出李四2. 数据类型转换ConvHelper.cs解决.NET原生类型转换繁琐、易出错的问题// 安全类型转换带默认值 int safeNum abc.ToInt(0); // 转换失败返回默认值0 double price 99.9.ToDouble(); bool isTrue true.ToBool(); // 路径处理 string webPath C:\files\image.jpg.ToUrlPath(); // 输出/files/image.jpg // 时间戳处理 long timestamp ConvHelper.GetTimeStamp(); // 13位时间戳 DateTime date ConvHelper.GetDateTimeFromTimestamp(timestamp); // 随机码生成 string verifyCode 0-9.ToRandomCode(6); // 6位数字验证码3. HTTP请求封装HttpHelper.cs简化HttpClient使用内置JSON支持和错误处理// GET请求 string response HttpHelper.HttpClientGet(https://api.example.com/users?id1); // POST请求自动序列化JSON var postData new { UserId 1, Name 新名称 }; string postResp HttpHelper.HttpClientPost(https://api.example.com/update, postData); // 带请求头的请求 var headers new Dictionarystring, string { { Authorization, Bearer your-token }, { Content-Type, application/json } }; string authResp HttpHelper.HttpClientGet(https://api.example.com/protected, headers);4. 加密工具MD5Encryption.cs适用于非敏感数据的MD5加密支持大小写输出// 基础加密 string password 123456; string md5Lower MD5Encryption.Encrypt(password); // 小写 string md5Upper MD5Encryption.Encrypt(password, true); // 大写 // 密码验证 bool isValid MD5Encryption.Compare(inputPwd, storedHash);⚠️ 注意MD5适用于非敏感数据用户密码等敏感信息建议使用BCrypt/Argon2算法5. Session/Cookie管理提供统一的Session/Cookie操作接口支持对象存储// Session操作 public class AccountController : Controller { private readonly IHttpSessionService _sessionService; public AccountController(IHttpSessionService sessionService) { _sessionService sessionService; } public IActionResult Login(string username) { // 存储字符串 _sessionService.SetSession(CurrentUser, username); // 存储对象 var userInfo new { Name username, Role Admin }; _sessionService.SetObjectAsJson(UserInfo, userInfo); return RedirectToAction(Index); } } // Cookie操作 _cookieService.SetCookies(AuthToken, abc123, 60); // 60分钟过期 string token _cookieService.GetCookies(AuthToken); _cookieService.DeleteCookies(AuthToken);6. 拼音处理Pinyin.cs中文转拼音首字母适用于搜索、排序场景// 中文转拼音首字母 string initials Pinyin.GetInitials(中文拼音处理); // 输出ZWPYCL // 搜索场景示例 public ListUser SearchUsers(string keyword) { string pinyinKey Pinyin.GetInitials(keyword).ToLower(); return _userRepo.SearchByPinyinKey(pinyinKey); }7. Excel处理基于NPOI支持Excel导入导出自动映射实体类// 定义数据模型 public class Product { public string Name { get; set; } public decimal Price { get; set; } public int Stock { get; set; } } // 导出Excel public void ExportProducts(ListProduct products) { var excelService new NpolExcelServiceProduct(); // 自定义表头映射 var headers new Dictionarystring, string { { Name, 产品名称 }, { Price, 价格 }, { Stock, 库存 } }; excelService.ExportToExcel(products, products.xlsx, 产品列表, headers); } // 导入Excel public ListProduct ImportProducts(string filePath) { var excelService new NpolExcelServiceProduct(); return excelService.ImportFromExcel(filePath); }8. 其他核心模块模块功能亮点适用场景验证码生成VerCode.cs生成指定长度数字验证码手机/邮箱验证码、交易验证验证工具VerificationHelper.csGuid验证、正则验证邮箱/手机号/身份证输入验证、数据校验配置管理统一读取appsettings.json、自定义JSON配置配置集中管理、多环境配置四、最佳实践指南1. 依赖注入最佳实践合理设置服务生命周期避免内存泄漏// Scoped每个请求一个实例用户服务、业务服务 builder.Services.AddScopedIUserService, UserService(); // Transient每次注入新实例工具类、临时服务 builder.Services.AddTransientIExcelService, ExcelService(); // Singleton全局单例缓存服务、配置服务 builder.Services.AddSingletonICacheService, CacheService();2. 错误处理策略// 安全数据处理封装 public class SafeDataProcessor { public int? SafeConvertToInt(string input) { try { return input.ToInt(); } catch { return null; } } public T SafeJsonDeserializeT(string json) where T : new() { try { return json.ToEntityT(); } catch { return new T(); } } } // 全局异常处理 app.UseExceptionHandler(options { options.Run(async context { var exception context.Features.GetIExceptionHandlerFeature(); if (exception ! null) { // 记录日志 Console.WriteLine($全局异常{exception.Error.Message}); // 返回友好响应 context.Response.StatusCode 500; await context.Response.WriteAsJsonAsync(new { success false, message 服务器处理失败请稍后重试 }); } }); });3. 性能优化建议缓存策略public class CachedUserService : IUserService { private readonly IUserService _userService; private readonly ICacheService _cacheService; public async TaskUser GetUserById(int id) { string cacheKey $User:{id}; // 优先从缓存获取 var cachedUser _cacheService.GetUser(cacheKey); if (cachedUser ! null) return cachedUser; // 缓存未命中从数据库获取 var user await _userService.GetUserById(id); // 存入缓存10分钟过期 _cacheService.Set(cacheKey, user, TimeSpan.FromMinutes(10)); return user; } }异步操作// 控制器异步示例 [HttpGet({id})] public async TaskIActionResult GetUser(int id) { try { var user await _userService.GetUserById(id); return Ok(user); } catch (Exception ex) { return BadRequest(new { message ex.Message }); } }4. 安全最佳实践密码安全处理加盐MD5public string HashPassword(string password) { // 生成8位盐值 string salt Guid.NewGuid().ToString().Substring(0, 8); // 密码盐值加密 return MD5Encryption.Encrypt(password salt) : salt; } // 密码验证 public bool VerifyPassword(string inputPwd, string storedHash) { var parts storedHash.Split(:); if (parts.Length ! 2) return false; string hash parts[0]; string salt parts[1]; return MD5Encryption.Encrypt(inputPwd salt) hash; }输入验证// 常用验证正则 public static class ValidationPatterns { public const string Email ^[\w-](\.[\w-])*[\w-](\.[\w-])$; public const string Phone ^1[3-9]\d{9}$; public const string IdCard ^[1-9]\d{5}(18|19|20)\d{2}(0[1-9]|1[0-2])(0[1-9]|[12]\d|3[01])\d{3}[\dXx]$; } // 验证逻辑 public bool ValidateUser(User user) { if (user.Id.IsDefault()) return false; if (!user.Email.RegexVerification(ValidationPatterns.Email)) return false; if (!user.Phone.RegexVerification(ValidationPatterns.Phone)) return false; return true; }五、依赖与兼容性核心依赖包依赖包用途推荐版本Newtonsoft.JsonJSON序列化13.0.4NPOIExcel操作2.7.5Microsoft.Extensions.DependencyInjection依赖注入9.0.11.NET8/9、10.0.3.NET10Microsoft.Extensions.Caching.Abstractions缓存抽象9.0.11.NET8/9、10.0.3.NET10版本兼容性✅ .NET 8.0完全支持✅ .NET 9.0完全支持✅ .NET 10.0完全支持六、常见问题排查1. 配置文件读取失败检查appsettings.json是否存在于项目根目录确认配置项路径正确如ConnectionStrings:DefaultConnection验证JSON格式是否合法2. Excel导入失败确认安装NPOI包dotnet add package NPOI检查Excel文件格式是否正确.xlsx/.xls验证实体类属性与Excel列名映射是否一致确保应用程序有文件读取权限3. 依赖注入报错确认已调用builder.Services.AddAcmeBuilderServer()检查服务生命周期是否正确避免Singleton注入Scoped验证接口与实现类是否正确注册七、总结Acme .NET工具类库通过封装日常开发中的高频功能帮助开发者减少重复代码提升开发效率。无论是小型项目快速开发还是大型项目的基础组件建设Acme都能提供可靠的支持。核心优势回顾 开箱即用NuGet一键安装快速集成 功能全面11大核心模块覆盖绝大部分开发场景 性能优异内置异步、缓存等性能优化方案 安全可靠遵循安全开发最佳实践 易于维护完善的文档和示例降低维护成本如果你正在寻找一款能解决.NET开发中各种琐碎问题的工具库Acme绝对值得一试。无论是新手入门还是资深开发者提升效率都能从中受益。技术支持 邮箱支持yzxs949163.com 文档地址Acme官方文档 问题反馈发邮件提供截图和详细报错以及Acme版本、.NET版本、完整错误信息和重现步骤最后技术的价值在于解决问题Acme工具库的设计理念就是让开发者把更多精力放在业务逻辑上而非重复的基础功能开发。希望这款工具库能成为你.NET开发路上的好帮手
