该技能用于创建 Go 包、组织导入、管理依赖,或决定如何把 Go 代码拆分为包时参考,也适用于启动新的 Go 项目。资料给出两条资源路由:references/IMPORTS.md 用于导入分组、空白导入、点导入和导入别名;references/PACKAGE-SIZE.md 用于拆分包、避免 init、组织 main、设计 CLI 标志与子命令。
包组织上,建议避免 util、helper、common 这类通用包名,包名应说明其提供的内容;通用词可作为名称一部分(如 stringutil),但不应作为完整包名。包体积方面,若无法用一句话描述用途,应按职责拆分;文件间不共享未导出符号时可拆为独立包;不同用户群使用不同部分时按用户边界拆分;godoc 页面过于庞杂时可拆分以便发现。不应仅因文件长、为创建单类型包或会造成循环依赖而拆分。
导入需按组用空行分隔,标准库始终在前,可用 goimports 自动管理。规则包括:分组为 stdlib 在前、外部在后;避免重命名导入,除非发生冲突,且应重命名最局部的导入,proto 包加 pb 后缀;空白导入仅用于 main 包或测试;点导入除非循环依赖的测试文件,否则不要使用。
应尽量避免 init(),不可避免时须完全确定、不依赖其他 init() 顺序、不依赖环境状态、不进行 I/O;可接受用途包括无法用单次赋值表达的复杂表达式、可插拔钩子(如 database/sql 方言)和确定性的预计算。os.Exit 或 log.Fatal* 只能在 main() 中调用,其他函数应返回错误;推荐 run() 模式,将逻辑提取为 func run() error 并由 main() 调用。命令行标志建议仅在 package main 中定义,名称使用 snake_case,库应以参数接收配置而非直接读取标志;优先标准库 flag,仅在需要 POSIX 约定时使用 pflag。
不适用情形:包内单个标识符命名见 go-naming;单文件内函数组织见 go-functions;强制导入规则的 linter 配置见 go-linting。相关技能还包括跨包错误包装(%w 与 %v)、goimports local-prefixes 配置和用显式初始化替代 init()。安装与具体版本信息暂未提供。