# CommonUtils

**Repository Path**: qy_chen/CommonUtils

## Basic Information

- **Project Name**: CommonUtils
- **Description**: 本工具为从 Java 转向 C# 的开发者设计，旨在帮助熟悉 Java 生态（如 Hutool、Apache Commons 等库）的开发人员快速上手 C# 开发。通过提供类似 Java 工具库的 API 风格和常用功能封装，降低学习曲线，提升开发效率。
- **Primary Language**: C#
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: https://gitee.com/qy_chen/CommonUtils
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-08-09
- **Last Updated**: 2025-08-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: CShap工具类

## README



# C# common-utils 开发辅助工具说明

## 工具概述
`common-utils` 是一个 C# 工具库，提供丰富实用方法简化开发流程，涵盖文件、网络、加密、数据处理、系统信息获取等多个领域，旨在提高开发效率。

## 核心功能模块
- **ArrayUtil**: 数组操作工具类，提供数组创建、合并、过滤等功能。
- **BeanUtil**: Bean与Dictionary相互转换工具，支持属性复制与动态获取/设置属性值。
- **CollUtil**: 集合操作工具，包括集合创建、交并差集、筛选、分页等。
- **DateUtil**: 日期时间操作工具，提供日期格式化、比较、偏移、解析等功能。
- **DesensitizedUtil**: 数据脱敏工具，支持手机号、身份证号、银行卡号等敏感信息脱敏。
- **DictUtil**: 字典操作工具，提供字典创建、合并、过滤、获取键值等功能。
- **FileUtil**: 文件操作工具，包含文件读写、重命名、删除、目录操作等。
- **FTPUtil**: FTP文件上传/下载工具，支持创建目录、重命名、删除等。
- **HttpRequest & HttpUtil**: HTTP请求工具类，支持GET、POST、文件下载、JSON请求等。
- **IdUtil**: 唯一ID生成工具，支持UUID、NanoID、Snowflake等。
- **IniConfigUtil**: INI配置文件读写工具。
- **Ipv4Util**: IPv4地址转换及验证工具。
- **JsonUtil & JsonUtilPro**: JSON序列化、反序列化、读写文件、格式化、XML与JSON互转等。
- **MySQLJdbcUtil**: MySQL数据库操作工具，支持连接、执行SQL、事务处理等。
- **NetUtil**: 网络工具，包含端口检测、IP处理、DNS解析等。
- **NumberUtil**: 数值操作工具，支持数值转换、基本数学运算、随机数生成等。
- **PropsUtil**: 属性文件读写工具。
- **RandomUtil**: 随机数据生成，包括字符串、数字、颜色、日期等。
- **ReflectUtil**: 反射工具类，支持动态创建实例、调用方法、获取/设置属性值。
- **RegexUtil**: 正则表达式工具，支持匹配、替换、提取、分组等。
- **RuntimeUtil**: 系统运行时工具，包含执行Shell命令、获取环境变量、操作系统判断等。
- **SecureUtil**: 安全工具类，提供AES、DES、3DES、RSA、DSA等加密/解密及签名/验证方法。
- **SmUtil**: 国密算法工具，支持SM2、SM3、SM4。
- **SftpNativeUtil**: SFTP客户端工具，用于文件传输。
- **SnowflakeIdGenerator**: 分布式ID生成器，使用Snowflake算法。
- **StringUtil**: 字符串操作工具，包括判空、截取、格式化、拼接、替换等。
- **SystemUtil**: 系统信息获取工具，支持获取操作系统、内存、CPU、.NET运行时等信息。
- **ThreadUtil**: 多线
- **XmlUtil**: XML文档解析、生成、序列化/反序列化工具。
- **YamlUtil**: YAML文件加载、解析、序列化工具。
- **ZipUtil**: ZIP压缩、解压、文件操作工具。

## 快速开始

### 安装
下载源码后，通过Visual Studio或CLI编译并引用项目。

### 引用命名空间
```csharp
using common.utils.core;
```

### 开始使用
示例：使用 `DateUtil` 获取当前日期时间
```csharp
DateTime now = DateUtil.Now();
Console.WriteLine(DateUtil.FormatDateTime(now));
```

## 特色功能
- **多平台支持**: 包括Windows、Linux、macOS等。
- **安全工具**: 提供多种加密算法，如AES、RSA、SM4等。
- **数据脱敏**: 针对敏感信息如身份证、银行卡等脱敏处理。
- **网络工具**: HTTP、FTP、SFTP请求支持。
- **数据格式处理**: JSON、XML、YAML、CSV等格式转换及操作。

## 学习建议
- 初学者可从 `StringUtil`、`DateUtil` 等简单工具入手。
- 中级开发者可尝试 `ReflectUtil`、`SecureUtil` 等高级功能。
- 高级开发者可深入研究 `SnowflakeIdGenerator` 和 `SftpNativeUtil` 的实现。

## 版本信息
当前版本为1.0.0，支持.NET 6及以上版本。

## 结语
`common-utils` 提供了C#开发中的常用工具类，使开发者可以专注于业务逻辑而减少重复代码编写。

## 贡献
欢迎提交Issue和Pull Request，帮助改进项目质量与功能。

## Gitee 特性
- **Issue管理**: 提供模板，便于清晰描述问题。
- **Pull Request**: 提供模板，便于代码合并与审查。
- **代码搜索**: 支持快速查找项目中的代码结构。
- **文档协作**: 支持多人协作编写文档。

## 许可证
本项目使用MIT License。详情请查看LICENSE文件。