# x-golang

**Repository Path**: cross-lang/x-golang

## Basic Information

- **Project Name**: x-golang
- **Description**: 一个实用的 Golang 工具集合，提供了多种客户端工具和 SDK 使用示例


- **Primary Language**: Go
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2023-08-27
- **Last Updated**: 2026-02-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# x-golang

<p align="center">
  一个实用的 Golang 工具集合，提供了多种客户端工具和 SDK 使用示例
</p>

## 项目定位

本项目旨在为 Golang 开发者提供一套实用的工具集合，涵盖了日常开发中常用的各种功能模块，包括但不限于 HTTP 工具、JSON 处理、时间工具、加密工具等。同时，项目还提供了多种客户端工具和 SDK 使用示例，帮助开发者快速上手和应用。

## 目录结构

```
.
├── clients/      # 客户端工具
├── drafts/       # 草稿代码
├── guides/       # 开发指南和教程
│   ├── basis/    # 基础语法示例
│   └── packages/ # 常用包使用示例
├── sdks/         # SDK 使用示例
├── temps/        # 临时文件
└── utils/        # 工具函数集合
```

## 核心功能

### utils 工具包

- **http_util**: HTTP 请求工具，支持 GET、POST 等方法
- **json_util**: JSON 序列化和反序列化工具
- **time_util**: 时间处理工具
- **str_util**: 字符串处理工具
- **int_util**: 整数处理工具
- **slice_util**: 切片操作工具
- **sm3_util**: SM3 加密工具
- **sm4_util**: SM4 加密工具
- **aes_util**: AES 加密工具
- **rsa_util**: RSA 加密工具
- **sm2_util**: SM2 加密工具
- **file_util**: 文件操作工具
- **ctx_util**: 上下文工具
- **coding_util**: 编码工具
- **gen_util**: 生成工具
- **owe_util**: 其他工具
- **prompt_util**: 提示工具
- **style_util**: 样式工具

### clients 客户端工具

提供了各种客户端工具的实现，方便开发者快速集成和使用。

### sdks SDK 使用示例

包含了各种 SDK 的使用示例，帮助开发者快速上手第三方服务。

### guides 开发指南

- **basis**: 包含了 Golang 基础语法的各种示例
- **packages**: 包含了 Golang 常用包的使用示例

## 安装与使用

### 安装

```bash
go get github.com/yeyushilai-team/x-golang
```

### 使用示例

#### HTTP 工具使用示例

```go
import "github.com/yeyushilai-team/x-golang/utils"

// 创建 HTTP 工具实例
httpUtil := utils.NewHttpUtil()

// 发送 GET 请求
var response interface{}
header := map[string]string{
    "Content-Type": "application/json",
}
err := httpUtil.Get("https://api.example.com/data", header, &response)
if err != nil {
    // 处理错误
}

// 发送 POST 请求
request := map[string]string{
    "key": "value",
}
var postResponse interface{}
err = httpUtil.PostV1("https://api.example.com/data", header, request, &postResponse)
if err != nil {
    // 处理错误
}
```

## 贡献指南

1. Fork 本仓库
2. 创建特性分支 (`git checkout -b feature/amazing-feature`)
3. 提交更改 (`git commit -m 'Add some amazing feature'`)
4. 推送到分支 (`git push origin feature/amazing-feature`)
5. 打开 Pull Request

## Issue 声明

- 请在提交 Issue 前先搜索是否已有相关 Issue
- 提交 Issue 时请详细描述问题，包括：
  - 问题现象
  - 复现步骤
  - 期望结果
  - 实际结果
  - 环境信息（如 Go 版本、操作系统等）
- 对于 Bug 报告，请尽可能提供最小复现示例

## 使用规范

1. 本项目仅供学习和参考使用
2. 在生产环境中使用前，请确保充分测试
3. 如需修改代码，请遵循项目的代码风格和规范
4. 引用本项目时，请注明来源

## 许可证

本项目采用 MIT 许可证 - 详见 [LICENSE](LICENSE) 文件

## 联系方式

如有问题或建议，欢迎通过以下方式联系我们：

- GitHub Issues: [https://github.com/yeyushilai-team/x-golang/issues](https://github.com/yeyushilai-team/x-golang/issues)