应谨慎抽离工具类，仅当逻辑跨包复用、强解耦且无上下文依赖时才独立成包；推荐先用GoLand Extract Function生成函数，再手动迁移并确保导出、通用性、命名规范与文档完整。
提取前先确认是否真需要独立工具类
不是所有重复代码都适合抽成“工具类”。GoLand 的 Extract Function 或 Extract Method 默认生成的是当前包内的函数，这是最安全、最符合 Go 习惯的做法。只有当逻辑跨包复用、与业务强解耦、且不依赖具体上下文（比如 *testing.T、http.ResponseWriter）时，才考虑放到独立工具包里。否则强行拆出会增加 import 负担、模糊职责边界，还可能引发循环依赖。
用 Extract Function 提取后手动移包
GoLand 没有“一键提取到新包”的重构选项。正确路径是：先在原文件中用 Extract Function（快捷键 Ctrl+Alt+Shift+T → 选 Extract Function）生成函数，再手动移动：
- 复制新函数的签名和实现体
- 在目标包（如
pkg/util）下新建util.go文件 - 粘贴函数，确保首字母大写（导出）、无包内变量/方法依赖
- 删掉原位置的函数，补上对应 import（如
"myproject/pkg/util"） - 运行
go mod tidy确保依赖干净
注意：如果函数用了当前包的私有类型或常量，必须一并迁移或重构为通用类型（如用 string 替代 myproj.Status），否则编译失败。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
避免命名冲突和导出污染
工具函数名容易撞车，尤其像 Format、Parse、Trim 这类泛用词。实际操作中建议：
- 函数名加前缀，例如
HTTPParseURL、JSONSafeUnmarshal，而不是裸名Parse - 不要为了“工具类”而堆砌函数——一个文件只放 3–5 个语义紧密的函数，比如
FileExists、ReadFileToString、WriteStringToFile可以同属fsutil，但别把加密、时间、网络全塞进去 - 导出函数必须带完整文档注释（
// FormatDate formats time to "2006-01-02"），否则其他包调用时无法通过godoc查到
t.Helper() 不适用于工具类函数
测试帮助函数必须调用 t.Helper()，但普通工具函数不能也不该依赖 *testing.T。如果你发现想把测试里的断言逻辑（如 assert.Equal(t, a, b)）抽成工具函数，说明设计错了——断言属于测试域，应留在 _test.go 文件里，或用现成的 testify/assert 等库。工具类只处理纯数据转换、计算、格式化等无副作用操作。
真正容易被忽略的是包初始化顺序和空标识符导入：工具包若含 init() 函数，或依赖 _ "net/http/pprof" 这类副作用导入，会悄悄污染主程序行为。移包后务必检查 go build -a -v 输出，确认没引入意外依赖。
