Go语言代码组织核心是包和模块：包由package声明定义，是最小复用单元；模块以go.mod为标志，管理版本化依赖与项目边界；推荐cmd/、internal/、pkg/等分层目录结构。
Go 语言的代码组织核心在于包（package）和模块（module）两个层级，不是靠目录或文件名自动决定，而是由 package 声明和 go.mod 文件共同定义。写得清楚、分得合理，才能让项目可读、可测、可维护。
包（package）：最小的复用与编译单元
每个 .go 文件开头必须有 package xxx 声明，同目录下所有文件必须属于同一个包（例外：测试文件可为 xxx_test 包）。包名通常小写、简洁、见名知意，比如 http、sql、user。
- 主程序入口必须是
package main，且含func main() - 导出标识符（函数、类型、变量）首字母大写，如
User、Save()；小写则仅在包内可见 - 避免跨包直接操作内部字段，通过方法封装行为，比如用
u.GetName()而非u.name
模块（module）：版本化依赖与项目边界
模块以 go.mod 文件为标志，通过 go mod init example.com/myapp 初始化。它声明了模块路径（即导入路径前缀）、Go 版本和第三方依赖。
- 模块路径不一定是真实 URL，但应具备唯一性和可读性，例如
github.com/yourname/project - 同一模块内，导入路径以模块路径开头，如
import "example.com/myapp/user"对应./user/xxx.go - 依赖自动记录在
go.mod，运行go mod tidy可同步增删依赖项
常见目录结构建议（非强制，但实用）
Go 没有官方框架式结构，但社区普遍接受清晰分层。以 Web 服务为例：
立即学习“go语言免费学习笔记（深入）”；
-
cmd/：存放多个可执行命令，如cmd/api/main.go、cmd/cli/main.go -
internal/：仅本模块使用的包，外部无法导入（Go 1.4+ 自动限制） -
pkg/：可被其他项目复用的公共包（导出接口稳定、有文档、带测试） -
api/或handler/：HTTP 路由与请求处理逻辑 -
service/：业务逻辑，不依赖 HTTP 或数据库细节 -
model/或domain/：数据结构定义（如User、Order） -
storage/：数据持久化实现（SQL、Redis、mock 等）
模块化编码小技巧
写 Go 时保持“包职责单一”，一个包解决一类问题。比如 email 包只管发信逻辑，不掺杂模板渲染或用户查询。
- 接口定义尽量放在调用方所在包（如
service定义EmailSender），实现在email/包里——利于 mock 和替换 - 避免循环导入：A 包不能直接 import B，B 又 import A；可通过提取公共接口到
pkg/解耦 - 测试文件与源码同名（
xxx.go↔xxx_test.go），测试包名一般为xxx_test，可访问原包导出项，也可用import . "xxx"简化测试调用
基本上就这些。Go 的模块化不靠语法糖，而靠约定 + 工具 + 清晰边界。写多了会发现：结构越简单，扩展反而越稳。
