gookit/goutil v0.7.1 发布：增强工具集与使用优化

我们很高兴地宣布 gookit/goutil v0.7.1 正式发布！作为 v0.7.0 系列的第一个补丁版本，本次更新带来了 20+ 新功能、关键错误修复以及多项性能优化，进一步提升了开发体验和工具库的实用性。

Github: https://github.com/gookit/goutil

版本亮点

1. 时间处理能力增强

• timex.ToDuration() 方法现在支持负数和复合时间格式
• 支持如 -1.5h、2d3h、2hour33min 等多种时间表示方式
• 简化时间计算逻辑，提升代码可读性

2. 映射操作工具新增功能

• 新增 AnyToStrMap() 函数，实现任意类型到字符串映射的转换
• 引入 L2StrMap 类型，支持二级字符串映射操作
• Data 类型新增多个实用方法：One()、StrOne()、BoolOne() 等
• 添加切片到映射的转换函数：SliceToSMap()、SliceToMap()、SliceToTypeMap()

3. 字符串处理增强

• 新增不区分大小写的字符串检查函数：IContainsOne()、IContainsAll()
• 添加快速逗号连接函数 JoinComma()
• 引入 IsVarName() 函数，用于变量名格式验证

4. 文本工具增强

• 新增 StrVarRenderer，实现类似 shell 变量渲染器的功能
• 简化测试中的变量替换和模板渲染操作

主要功能详解

时间处理增强

// 支持负数和复合时间格式 duration, err := timex.ToDuration("-1.5h") // -1 小时 30 分钟 duration, err := timex.ToDuration("2d3h") // 2 天 3 小时 duration, err := timex.ToDuration("2hour33min") // 2 小时 33 分钟 

映射操作升级

// 任意类型到字符串映射的转换 strMap := maputil.AnyToStrMap(someData) // 多键值获取 value := data.One("key1", "key2", "key3") // 尝试多个键，返回第一个存在的值 // 切片到映射的转换 slice := []string{"a:1", "b:2", "c:3"} sMap := maputil.SliceToSMap(slice, ":") // {"a": "1", "b": "2", "c": "3"} 

字符串处理新功能

// 不区分大小写的包含检查 strutil.IContainsOne("Hello World", []string{"hello", "golang"}) // true // 快速逗号连接 result := strutil.JoinComma([]string{"a", "b", "c"}) // "a,b,c" // 变量名验证 isValid := strutil.IsVarName("valid_var123") // true 

文本工具增强

简单的实现类似 php, kotlin, shell 插值变量渲染，表达式解析处理。

• var format: $var_name, ${some_var}, ${top.sub_var}
• func call: ${func_name($var_name, 'const string')}

// 使用 StrVarRenderer 进行变量渲染 renderer := textutil.NewStrVarRenderer() result := renderer.Render("Hello ${name}", map[string]string{"name": "World"}) // "Hello World" 

错误修复

• 修复了 maputil.TryAnyMap 在处理非字符串键映射时的转换错误
• 修复了内部 ParseEnvLines 在某些情况下的解析错误
• 优化了多个测试用例，提高了测试稳定性

其他重要更新

• feat：structs - StructToMap 添加新选项：IgnoreEmpty 、UserFunc 001c4da
• feat：structs - SetValues 添加新选项：BeforeSetFn 钩子 4a8b758

重构与优化

• 将 SMap 重命名为 StrMap，提高命名一致性
• 提取公共 ENV 行解析方法到内部包，减少代码重复
• jsonutil 新增 DecodeFile 函数，简化文件读取操作

文档与测试

• 更新了 structs、testutil、x/finder 等模块的文档
• 增强了测试覆盖率，修复了多个测试用例
• 更新了 GitHub Actions 工作流，使用最新的 checkout action

升级指南

安装/更新

go get github.com/gookit/goutil/v0.7.1 

注意事项

1. API 变更：SMap 已重命名为 StrMap，请更新相关代码
2. 新功能：建议查看新增函数，可能简化现有代码逻辑
3. 错误修复：如果之前遇到 TryAnyMap 的转换问题，现已修复

性能优化

• 优化了映射操作的性能，特别是在处理大型数据结构时
• 改进了字符串处理函数的内存使用效率
• 增强了测试工具的稳定性，减少测试中的不确定性

社区与贡献

感谢所有为本次版本做出贡献的开发者！我们欢迎社区反馈和贡献，如果您有任何建议或发现问题，请通过 GitHub Issues 告诉我们。

资源链接

• 完整变更日志
• 包文档 OR https://zread.ai/gookit/goutil
• 问题反馈

立即升级体验新特性，享受更高效的 Go 开发体验！