# golibv2

**Repository Path**: lsy007/golibv2

## Basic Information

- **Project Name**: golibv2
- **Description**: go 语法糖、常用SDK
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-15
- **Last Updated**: 2026-02-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# golibv2

`golibv2` 是一个 Go 工具层仓库，当前主模块位于 `v2/`，用于沉淀可复用的基础能力封装，不承载业务语义。

## 仓库说明

- 当前可用模块：`v2/`
- 模块路径：`gitee.com/lsy007/golibv2/v2`
- Go 版本：`go 1.23`（见 `v2/go.mod`）

> 说明：仓库根目录不是 Go module，请在 `v2/` 目录下执行构建与测试命令。

## 目录结构

```text
golibv2/
├─ AGENTS.md               # 仓库协作与代码规范
├─ README.md               # 仓库总览（当前文件）
└─ v2/                     # 主模块
   ├─ go.mod
   ├─ go.sum
   ├─ README.md
   ├─ script/              # 辅助脚本
   ├─ sdk/                 # 外部服务 SDK 封装
   ├─ tool/                # 通用工具层
   │  ├─ db/
   │  │  ├─ gormx/
   │  │  ├─ mongodbx/
   │  │  └─ redisx/
   │  ├─ geoip/
   │  ├─ logger/
   │  └─ timex/
   ├─ util/                # 轻量工具函数
   │  ├─ slicex/
   │  ├─ stringx/
   │  ├─ uuidx/
   │  └─ validate/
   └─ third_party/         # 第三方镜像或资源
```

## 快速开始

在仓库根目录执行：

```bash
cd v2
go test ./...
```

常用子包测试：

```bash
go test ./tool/db/gormx
go test ./tool/db/redisx
go test ./tool/db/mongodbx
go test ./sdk/loki
```

## 依赖方式

在你的 Go 项目中引入：

```bash
go get gitee.com/lsy007/golibv2/v2@latest
```

示例：

```go
import "gitee.com/lsy007/golibv2/v2/tool/db/redisx"
```

## 开发约定（摘要）

- `v2/*` 采用重构设计思路，不以兼容旧结构为默认目标。
- 工具包命名优先 `*x` 风格（如 `gormx`、`redisx`、`mongodbx`）。
- 模型定义与行为方法分离：模型放 `*_model.go`，方法放功能文件。
- 公共模型、公共方法及字段注释使用清晰中文，禁止乱码。
- 默认补齐本地可稳定运行的单元测试，不依赖外部真实服务。

## 更多文档

- `v2/README.md`：`v2` 模块总览
- `v2/script/README.md`：脚本目录说明
- `v2/sdk/README.md`：SDK 层说明
- 各子包 `README.md`：详细用法与示例