# 工具类管理库ExUtil
**Repository Path**: mofees/ruovea-extend
## Basic Information
- **Project Name**: 工具类管理库ExUtil
- **Description**: ruovea.extend.package 是一系列扩展工具类库的集合，旨在简化开发流程，提高代码的可维护性和可读性。这些工具类库涵盖了从自动服务注入到日志记录、从加密解密到文件操作等多个方面的功能，为开发者提供了全面的解决方案。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: NetCore
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-08-18
- **Last Updated**: 2026-08-18
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
RuoVea.Extend
.NET 8.0 / 10.0 | 21 个 NuGet 包 | MIT | 跨平台
---
# 🛠️ RuoVea.Extend
> **.NET 开发者的一站式企业级工具包** — 涵盖安全加密、动态 API、事件驱动、缓存、日志、分布式 ID 等 20+ 模块的"瑞士军刀级"组件生态。按需引用，零负担集成。
---
## ✨ 为什么选择 RuoVea.Extend？
| 🧩 模块化设计 | 🔐 企业级安全 | 🚀 DDD 友好 | 🇨🇳 本土化适配 |
|:---:|:---:|:---:|:---:|
| 按需引用，拒绝全家桶 | AES/RSA + 国密 SM 系列 | DynamicWebApi 零 Controller | 拼音/身份证/粤语 |
---
## 🗺️ 组件全景图
> 点击组件名可跳转至详细文档。
### 🔗 核心架构
| 组件 | 核心功能 | 技术亮点 |
|:---|:---|:---|
| **Autowired** | 自动依赖注入 | 简化 DI 配置，减少手动注册代码 |
| [**DynamicWebApi**](NetCore/RuoVea.DynamicWebApi/README.md) | 动态生成 RESTful API | DDD 架构，零 Controller 层直接暴露服务 |
| **ExEvenBus** | 事件总线（单机版） | 事件驱动架构，可扩展为分布式 |
| [**ExFilter**](NetCore/RuoVea.ExFilter/README.md) | 全局拦截器 | 异常/操作日志/参数验证，AOP 统一处理 |
### 🔐 安全与认证
| 组件 | 安全功能 | 特色 |
|:---|:---|:---|
| [**ExCrypt**](NetCore/RuoVea.ExCrypt/README.md) | 多算法加密（AES/RSA/SM2-SM4/MD5） | 支持国密算法，多语言敏感数据处理 |
| [**ExPws**](NetCore/RuoVea.ExPws/README.md) | 增强版加密（含国密 SM 系列） | PBKDF2.Key 等工业级算法，粤语/日语等场景 |
| [**ExJwtBearer**](NetCore/RuoVea.ExJwtBearer/README.md) | 多模式认证（JWT/Basic/OAuth2.0） | 开箱即用的 IdentityServer4 集成 |
| **ExWeb** | IP 白名单 / CORS / JWT 配置 | 安全策略集中管理 |
### ⚙️ 基础设施工具
| 组件 | 功能 | 典型场景 |
|:---|:---|:---|
| [**ExIdGen**](NetCore/RuoVea.ExIdGen/README.md) | 分布式 ID 生成（雪花漂移算法） | 高并发订单号生成，支持数据中心 ID |
| [**ExCache**](NetCore/RuoVea.ExCache/README.md) | 统一缓存操作接口 | 多级缓存策略抽象 |
| **ExFile** | 文件/压缩包操作（ZipHelper 等） | 批量文件处理与二进制流管理 |
| [**ExConfig**](NetCore/RuoVea.ExConfig/README.md) | 动态配置读取 | 强类型配置绑定 |
### ⚡ 开发效率增强
| 组件 | 价值点 | 亮点 |
|:---|:---|:---|
| [**ExUtil**](NetCore/RuoVea.ExUtil/README.md) | 全能工具集 | 验证/类型转换/树结构/拼音等 300+ 方法 |
| [**ExSwagger**](NetCore/RuoVea.ExSwagger/README.md) | Swagger 自动化配置 | 零配置 API 文档生成 |
| [**ExDto**](NetCore/RuoVea.ExDto/README.md) | 通用 DTO/枚举/接口定义 | 标准化团队协作契约 |
| [**ExLog**](NetCore/RuoVea.ExLog/README.md) | 可扩展日志框架 | 多日志格式和跨版本兼容 |
### 🎯 特殊场景解决方案
| 组件 | 解决痛点 | 技术细节 |
|:---|:---|:---|
| **ExCaptcha** | 图形验证码生成 | .NET Standard 2.0，高复杂度扭曲文本 |
| **ExHtml** | HTML 解析与远程下载 | 网页内容抓取与 DOM 操作 |
| **ExGlobal** | 全局错误日志追踪 | 生产环境故障诊断 |
| **ExApp** | 上下文快捷访问 | 解决 ASP.NET Core 中 HttpContext 获取繁琐问题 |
### 🗄️ 数据库支持
| 组件 | 数据库相关功能 | 优势 |
|:---|:---|:---|
| [**ExSugar**](NetCore/RuoVea.ExSugar/README.md) | SqlSugar ORM 扩展 | 增强的 Sugar 查询能力和事务管理 |
---
## 📊 组件速览
```
🔗 核心架构 🔐 安全认证 ⚙️ 基础设施 ⚡ 效率增强 🎯 特殊场景
───────────────── ───────────────── ───────────────── ───────────────── ─────────────────
Autowired ExCrypt ExIdGen ExUtil ExCaptcha
DynamicWebApi ExPws ExCache ExSwagger ExHtml
ExEvenBus ExJwtBearer ExFile ExDto ExGlobal
ExFilter ExWeb ExConfig ExLog ExApp
ExSugar
```
---
## 💡 关键洞察
### 🧩 模块化设计
每个功能独立成包，避免"全家桶"式依赖，开发者可按需引用。NuGet 安装即用，零额外配置即可集成。
### 🔐 企业级安全
同时支持国际标准算法（AES/RSA）和国密算法（SM2/SM4），符合国内安全合规要求，金融政务场景首选。
### 🚀 DDD 友好
DynamicWebApi 直接映射领域层为 API，完美契合领域驱动设计架构，告别样板 Controller 代码。
### 🇨🇳 本土化适配
中文拼音处理、身份证/手机号验证、粤语/日语等多语言场景，针对国内业务场景的专用工具，填补官方库空白。
---
## 🎓 推荐学习路径
```
🥇 基础必备 🥈 进阶扩展 🥉 场景化选择
═══════════════════════════ ═══════════════════════════ ═══════════════════════════
ExUtil → 核心工具集 ExEvenBus → 事件驱动架构 ExCaptcha → 人机验证
ExCrypt → 安全加密基础 ExFilter → AOP 编程实践 ExSugar → 数据库加速
DynamicWebApi → 动态 API ExIdGen → 分布式 ID ExLog → 日志框架
```
| 阶段 | 组件组合 | 学习重点 |
|:---|:---|:---|
| 🥇 **基础必备** | `ExUtil` · `ExCrypt` · `DynamicWebApi` | 掌握核心工具集、安全加密基础和动态 API 架构 |
| 🥈 **进阶扩展** | `ExEvenBus` · `ExFilter` · `ExIdGen` | 深入事件驱动、AOP 编程和分布式系统设计 |
| 🥉 **场景化选择** | `ExCaptcha` · `ExSugar` · `ExLog` | 根据项目需求灵活选用人机验证、ORM 增强和日志 |
---
## 📦 安装指南
所有扩展工具类库均已发布至 [NuGet.org](https://www.nuget.org/)，支持 .NET 8.0 和 .NET 10.0。
### 使用 .NET CLI
```bash
# 核心架构
dotnet add package RuoVea.Autowired
dotnet add package RuoVea.DynamicWebApi
dotnet add package RuoVea.ExEvenBus
# 安全认证
dotnet add package RuoVea.ExCrypt
dotnet add package RuoVea.ExPws
dotnet add package RuoVea.ExJwtBearer
# 基础设施
dotnet add package RuoVea.ExIdGen
dotnet add package RuoVea.ExCache
dotnet add package RuoVea.ExFile
dotnet add package RuoVea.ExConfig
# 开发效率
dotnet add package RuoVea.ExUtil
dotnet add package RuoVea.ExSwagger
dotnet add package RuoVea.ExDto
dotnet add package RuoVea.ExLog
# 特殊场景
dotnet add package RuoVea.ExCaptcha
dotnet add package RuoVea.ExHtml
dotnet add package RuoVea.ExGlobal
dotnet add package RuoVea.ExApp
# 数据库
dotnet add package RuoVea.ExSugar
```
### 使用 Package Manager
```powershell
Install-Package RuoVea.Autowired
Install-Package RuoVea.DynamicWebApi
Install-Package RuoVea.ExEvenBus
Install-Package RuoVea.ExApp
Install-Package RuoVea.ExCache
Install-Package RuoVea.ExCaptcha
Install-Package RuoVea.ExConfig
Install-Package RuoVea.ExCrypt
Install-Package RuoVea.ExDto
Install-Package RuoVea.ExFile
Install-Package RuoVea.ExFilter
Install-Package RuoVea.ExGlobal
Install-Package RuoVea.ExHtml
Install-Package RuoVea.ExIdGen
Install-Package RuoVea.ExJwtBearer
Install-Package RuoVea.ExLog
Install-Package RuoVea.ExSwagger
Install-Package RuoVea.ExUtil
Install-Package RuoVea.ExWeb
```
> 💡 **提示**: 也可在 Visual Studio 的 NuGet Package Manager 中搜索 `RuoVea.*` 直接安装。
---
## 🌟 总结
> 这个库堪称 .NET Core 开发者的"瑞士军刀"——尤其是对国内开发者而言，其本土化功能填补了官方库的空白。建议通过实际项目实践来深入理解各组件的最佳组合方式。
通过这些工具类库，开发者可以更加高效地构建和维护应用程序，减少重复代码，提高代码质量。每个工具类库都提供了详细的文档，帮助开发者快速上手和深入使用。
---
MIT License · Made with ❤️ by RuoVea · 问题反馈