本文详解 go 中应用程序与可复用包在目录结构设计上的根本区别：应用强调逻辑分层与可维护性，而库追求导入简洁与语义清晰；同时澄清 gopath 时代与现代 go modules 下的实践演进。
本文详解 go 中应用程序与可复用包在目录结构设计上的根本区别：应用强调逻辑分层与可维护性，而库追求导入简洁与语义清晰；同时澄清 gopath 时代与现代 go modules 下的实践演进。
在 Go 生态中，“项目结构”并非由语言强制规定，而是由项目性质（应用 vs. 库）和依赖管理方式（GOPATH vs. Go Modules）共同决定。你观察到的差异——如 sqlx 所有文件置于根目录，而你的 my_app 按功能划分子目录——并非随意偏好，而是有明确的设计意图。
✅ 应用（Application）：按职责分层，结构服务于可维护性
当你构建一个独立运行的后端服务（如重写 Rails 流程的 CLI 或 HTTP 服务），推荐采用清晰的模块化布局，例如：
myproject/ ├── go.mod # Go Modules 根声明（现代标准） ├── main.go # package main，程序入口 ├── cmd/ # 可执行命令（支持多入口时） │ └── myapp/ │ └── main.go ├── internal/ # 仅本项目使用的内部包（不可被外部 import） │ ├── handler/ │ ├── service/ │ └── repository/ ├── pkg/ # 可被其他项目安全复用的公共包（如有） │ └── model/ # 如 domain model、DTO 等稳定接口 ├── vendor/ # （可选）锁定依赖副本（go mod vendor 后生成） └── README.md
? 关键原则：同一目录下所有 .go 文件必须属于同一个 package；跨目录引用需通过完整导入路径（如 "myproject/pkg/model"）。
✅ 库（Library / Package）：扁平化 + 语义化导入路径
像 sqlx 这类被广泛依赖的第三方库，其根目录即为 package sqlx 的唯一源码位置，原因在于：
立即学习“go语言免费学习笔记（深入）”；
- 导入路径即包名：用户写 import "github.com/jmoiron/sqlx"，Go 要求该路径下存在 package sqlx；
- 避免嵌套歧义：若 sqlx 放在 src/github.com/jmoiron/sqlx/sqlx/，则导入路径需为 .../sqlx/sqlx，既冗余又易混淆；
- 工具链友好：go get、go doc、IDE 跳转均依赖“导入路径 = 文件系统路径”的约定。
因此，库的结构本质是：一个 repo 对应一个可导入的顶层包（或少数紧密关联的子包，如 golang.org/x/net/http2）。
⚠️ 注意事项与现代实践建议
- 弃用 $GOPATH/src 手动管理：Go 1.11+ 默认启用 Modules，项目根目录的 go.mod 文件定义模块身份（如 module example.co/myapp），不再依赖 GOPATH 目录结构；
- vendor 不再必需：go mod vendor 是可选操作，生产环境更推荐 go build -mod=readonly 保证 reproducible build；
-
慎用 pkg/ vs internal/：
- internal/ 下的包仅限本模块内 import（Go 编译器强制校验）；
- pkg/ 无此限制，但应确保其 API 稳定、有文档、具备测试，才适合作为对外暴露的公共能力。
✅ 示例：现代 Go 应用结构（Modules 驱动）
# 初始化模块（推荐使用公司域名作前缀）
$ go mod init example.co/myapp
# 目录结构示意
example.co/myapp/
├── go.mod
├── go.sum
├── main.go // package main
├── internal/
│ ├── app/ // 应用核心逻辑（HTTP server, CLI logic）
│ └── datastore/ // 数据访问层（封装 sqlx 等）
├── pkg/
│ └── model/ // 可导出的领域模型（如 User, Order）
└── cmd/
└── myapp/
└── main.go // 仅含 import "example.co/myapp" + app.Run()导入时直接使用模块路径：
// main.go
package main
import (
"example.co/myapp/internal/app"
"example.co/myapp/pkg/model"
)总结：结构选择不是“对错”问题，而是契约设计——应用结构优化团队协作与长期迭代，库结构优化使用者体验与生态兼容性。拥抱 Go Modules 后，以 go.mod 为锚点、按语义分层、严守 internal 边界，便是当下最稳健的实践。
