Go包名应使用简洁、小写的单数形式，如user、http；拆包依据是“可独立演进”，非功能分层；internal/为私有实现，pkg/为可复用库，cmd/为入口；接口应定义在调用方或抽象包中。

包名应该用单数还是小写？

Go 语言规范明确要求包名必须是合法的标识符，且惯例是使用简洁、小写的单数形式，比如 user、http、sql。不要用复数（users）、驼峰（userHandler）或下划线（user_repo）。因为包名会出现在所有导入后的调用中，例如 user.New() 比 users.NewUser() 更自然，也避免和类型名重复造成混淆。

• 错误示例：package users → 导入后变成 users.User{}，语义冗余
• 正确示例：package user → user.User{} 或 user.New()，清晰无歧义
• 包名不强制与目录名一致，但绝大多数项目都保持一致；若不一致，需在 go.mod 中确保模块路径能解析到该包

何时该拆出新包？不是按功能层，而是按“可独立演进”

常见误区是机械照搬 MVC 或 Clean Architecture 的目录结构，把 handler、service、repository 强行分包。Go 的包边界核心标准是：是否具备独立的依赖、测试、版本控制和演化节奏。一个包如果总是和另一个包一起修改、一起发布、无法单独测试，那它大概率不该拆。

• 适合拆包的信号：go test ./pkg/xxx 能跑通且不依赖其他业务包；go list -f '{{.Deps}}' ./pkg/xxx 显示只依赖标准库或稳定第三方（如 github.com/google/uuid）
• 反模式：internal/handler 里全是 HTTP 相关逻辑，但每个 handler 都强依赖 internal/service 和 internal/repository —— 这三者实际是一个演化单元，合并在 internal/api 包里更合理
• 典型合理拆分：domain（纯结构+方法，零外部依赖）、storage（封装 SQL/Redis 实现，依赖 database/sql 但不依赖业务逻辑）

internal/ vs pkg/ vs cmd/：这三个目录的真实分工

Go 官方推荐的顶层结构不是教条，而是解决具体问题的工具：internal/ 是私有实现边界，pkg/ 是可被外部复用的库，cmd/ 是可执行入口。混用会导致依赖泄漏或复用困难。

• internal/ 下的包不能被本项目以外的模块 import —— Go 编译器强制检查，适合放领域模型、应用服务、基础设施适配器等专用于当前项目的代码
• pkg/ 应该像第三方库一样设计：有清晰 API、导出类型最小化、带文档注释、可独立 go test；例如 pkg/email 提供 Send(ctx, to, subject, body)，内部用 SMTP 或 SendGrid 都不影响调用方
• cmd/ 只做三件事：解析 flag / env、初始化依赖（DB、logger、config）、调用 main.Run()；每个命令一个子目录，如 cmd/myapp、cmd/migrate，便于构建多个二进制

接口定义放在哪？别在实现包里 export interface

Go 没有“接口必须提前声明”的约束，但把接口和实现耦合在同一包里，会锁死扩展能力。正确做法是让接口由使用者定义，或放在更抽象的包中。

• 错误做法：storage/postgres.go 里定义 type UserRepo interface { GetByID(id int) (*User, error) }，然后 postgres.UserRepoImpl 实现它 —— 外部无法替换实现，且测试只能用 mock 或真实 DB
• 推荐做法：在 domain/ 或 internal/port/ 中定义 type UserRepository interface，storage/postgres 包只 import 并实现它；调用方（如 internal/app）只依赖 domain 包，完全不知道 PostgreSQL 存在
• 额外好处：运行 go list -f '{{.Imports}}' ./internal/app 会显示只依赖 domain，不出现 storage/po

  

  stgres，证明依赖方向正确

package domain

type User struct {
	ID   int
	Name string
}

type UserRepository interface {
	GetByID(id int) (*User, error)
	Save(u *User) error
}

package postgres

import "myproject/domain"

type repo struct {
	db *sql.DB
}

func (r *repo) GetByID(id int) (*domain.User, error) {
	// 实现细节
}

// 注意：这里不 export repo 或 UserRepository
// 而是通过工厂函数返回 interface{}
func NewUserRepository(db *sql.DB) domain.UserRepository {
	return &repo{db: db}
}

# redis  # git  # go  # github  # app  # 工具  # ai  # google  # 标准库  # red  # mvc  # sql  # 封装  # Error  # 标识符  # int  # 接口  # internal  # Interface  # database  # postgresql  # http  # 重构  # 包里  # 放在  # 多个  # 复用  # 第三方  # 包中  # 是一个  # 都不  # 出现在  # 下划线 

相关栏目： 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571 】

相关推荐： Laravel如何使用Scope本地作用域_Laravel模型常用查询逻辑封装技巧【手册】  Laravel广播系统如何实现实时通信_Laravel Reverb与WebSockets实战教程  JavaScript中的标签模板是什么_它如何扩展字符串功能  如何用5美元大硬盘VPS安全高效搭建个人网站？  Laravel怎么定时执行任务_Laravel任务调度器Schedule配置与Cron设置【教程】  魔毅自助建站系统：模板定制与SEO优化一键生成指南  湖南网站制作公司,湖南上善若水科技有限公司做什么的？  常州企业网站制作公司,全国继续教育网怎么登录？  如何用VPS主机快速搭建个人网站？  Laravel怎么防止CSRF攻击_Laravel CSRF保护中间件原理与实践  如何在HTML表单中获取用户输入并用JavaScript动态控制复利计算循环  laravel怎么实现图片的压缩和裁剪_laravel图片压缩与裁剪方法  重庆市网站制作公司,重庆招聘网站哪个好？  装修招标网站设计制作流程,装修招标流程？  高端智能建站公司优选：品牌定制与SEO优化一站式服务  宙斯浏览器怎么屏蔽图片浏览 节省手机流量使用设置方法  如何打造高效商业网站？建站目的决定转化率  Laravel如何部署到服务器_线上部署Laravel项目的完整流程与步骤  如何确认建站备案号应放置的具体位置？  JavaScript实现Fly Bird小游戏  JS经典正则表达式笔试题汇总  Laravel Session怎么存储_Laravel Session驱动配置详解  5种Android数据存储方式汇总  C++用Dijkstra(迪杰斯特拉)算法求最短路径  新三国志曹操传主线渭水交兵攻略  浅述节点的创建及常见功能的实现  edge浏览器无法安装扩展 edge浏览器插件安装失败【解决方法】  Laravel软删除怎么实现_Laravel Eloquent SoftDeletes功能使用教程  如何快速配置高效服务器建站软件？  晋江文学城电脑版官网 晋江文学城网页版直接进入  详解Oracle修改字段类型方法总结  如何续费美橙建站之星域名及服务？  Laravel Debugbar怎么安装_Laravel调试工具栏配置指南  在线教育网站制作平台,山西立德教育官网？  Linux系统运维自动化项目教程_Ansible批量管理实战  如何生成腾讯云建站专用兑换码？  Laravel如何实现模型的全局作用域？（Global Scope示例）  laravel怎么用DB facade执行原生SQL查询_laravel DB facade原生SQL执行方法  iOS发送验证码倒计时应用  使用Dockerfile构建java web环境  Laravel如何使用Blade模板引擎？（完整语法和示例）  如何快速上传自定义模板至建站之星？  Laravel Seeder怎么填充数据_Laravel数据库填充器的使用方法与技巧  微博html5版本怎么弄发语音微博_语音录制入口及时长限制操作【教程】  nodejs redis 发布订阅机制封装实现方法及实例代码  成都品牌网站制作公司,成都营业执照年报网上怎么办理？  如何正确选择百度移动适配建站域名？  Windows10怎样连接蓝牙设备_Windows10蓝牙连接步骤【教程】  Laravel如何编写单元测试和功能测试？（PHPUnit示例）  在线制作视频网站免费,都有哪些好的动漫网站？