gopkg

gopkg

Go 常用工具集，为 Go 开发提供便捷的工具函数。

安装

go get github.com/Ccmuyu/gopkg

工具包概览

快速开始

类型转换

import (
    "github.com/Ccmuyu/gopkg/conv/str"
    "github.com/Ccmuyu/gopkg/conv/json"
)

str.Atoi("123")           // 123
str.Itoa(123)             // "123"
json.MustMarshal(map[string]int{"a": 1})  // {"a":1}

切片操作

import "github.com/Ccmuyu/gopkg/slices"

nums := []int{1, 2, 3, 4, 5}
evens := slices.Filter(nums, func(v int) bool { return v%2 == 0 })
// [2, 4]

doubled := slices.Map(nums, func(v int) int { return v * 2 })
// [2, 4, 6, 8, 10]

slices.Dedup([]int{1, 1, 2, 2, 3})
// [1, 2, 3]

日志

import "github.com/Ccmuyu/gopkg/logs"

ctx := logs.WithTraceID(context.Background(), "abc123")
logs.Info(ctx, "request processed")
// 2026-04-24 16:30:00.123 [INFO] [abc123] request processed

校验

import "github.com/Ccmuyu/gopkg/validation"

validation.IsEmail("test@example.com")  // true
validation.IsPhone("13812345678")       // true
validation.IsIP("192.168.1.1")          // true

测试

go test ./... -v

性能测试

go test ./... -bench=. -benchmem

详细性能报告见 docs/benchmark-report.md。

规范

1. 需要 Go 1.22+
2. 函数简短、直接
3. 每个功能配有测试
4. 测试辅助函数统一在 test 包