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

[jxia]

我们很高兴地宣布 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 开发体验！