上帝视角看 “Go 项目标准布局” 之争
煎鱼 -
大家好，我是煎鱼。
前段时间 Go 语言社区有一件事情引爆了热议，那就是 golang-standards/project-layout 项目的 “Go 项目的标准布局” 之争。
没想到，五一假期，认真一看，这个 issues 已经提出将近一个月了，仍然在热议阶段，我想，咱们需要好好的聊聊这个话题。
煎鱼带你了解下的前因后果，再分享我的看法和业务真实情况。
背景问题发生地在 GitHub 上有一个项目 Spaghetti（github.com/adonovan/spaghetti），是 Go 软件包的一个依赖性分析工具。
该项目的目录结构如下：
看上去并不复杂，代码量不多，文件平铺也不超过一屏，就是一个布局比较简单的项目。
有一位老哥提出了一个 PR，明确的期望该项目按照 golang-standards/project-layout 项目给出的 “标准” 布局来调整。：
我猜测该项目可能是因为把 Go、HTML、JS、PNG 和 go.mod 文件等摆在了一起，引起了该同学的一丝丝纠结，觉得比较乱？
“标准布局“ 长什么样子在 golang-standards/project-layout 项目中，其自称：
项目的组织名也是 "golang-standards"，其提供了一个基本的 Go 项目布局，精简展示如下：
project-layout
├── api
├── cmd
├── configs
├── docs
├── go.mod
├── init
├── internal
├── pkg
├── scripts
├── vendor
├── ...
go mod vendor 执行得到。/configs：配置文件模板或默认配置。/init：系统初始化（systemd、upstart、sysv）和进程管理（runit、supervisord）配置。/scripts:：用于执行各种构建，安装，分析等操作的脚本。更具体的布局介绍，大家可以参见 project-layout 项目的 README，其基本把方方面面的目录都考虑到了（人多力量大）。
由于内容过于长，因此就不一一展示了。
Russ Cox 现身原因不过很巧，该项目的作者是前 Google 员工，是 gopl.io 项目（5.1k stars）的作者。
在仅仅过去 23 分钟后，作为 GoTeam Leader 的 Russ Cox（@rsc）就现身，并提出新的 issue 表达出了反对意见：
在 golang-standards/project-layout 项目的 README 中有明确指出这不是官方的标准，有如下声称：
Russ Cox 主要是对声称 "这是一套 Go 生态系统中常见的历史和新兴的项目布局模式" 这一说法表示了 “不准确” 的意见。
例如：Go 生态系统中的绝大多数包都不会将可导入的包放在 pkg 子目录中。更广泛地说，这里描述的只是非常复杂的工程项目，而 Go 的仓库往往要简单得多。
另外，不幸的是，这套项目布局在组织名字上被称作 "golang-standards"（Golang 标准） 提出来，实际上并非真的是官方标准，有误导的情况存在。
Russ Cox 反对原因在了解 project-layout 项目所提供的 “标准“ 项目布局和 Russ Cox 提出 issues 的背景后。
我们进一步了解 Russ Cox 认为这不对的根本考虑。project-layout 这个项目有两个问题：
它声称是 Go 标准（Go standards）的主办方，但实际上并非如此，因为这些标准绝非 Go 官方标准。它提出的项目布局标准过于复杂，不是一个合理的标准。Go 项目布局的标准是什么提出这个 issues 后，出现了一大堆人追问 Russ Cox，到底何为 Go 项目的布局标准？
Russ Cox 给出了正式回应，一个可导入的 Go repo 的最小标准布局是：
在你的根目录下放一个 LICENSE 文件。在你的根目录下放一个 go.mod 文件。将 Go 代码放在 repo 中，放在根目录中，或者按照你认为合适的方式组织成一个目录树。就这样了，这就是 "标准"，没有那么复杂。不需要像 project-layout 项目一样的布局。像是 Go 官方的 golang.org/x 仓库打破了 project-layout 所说的这些 "规则 "中的每一条。
在经历了长时间的口水战后，已经有人在 Go 官方仓库提出希望释出相关的提案（proposal）：
猜测可能会有如下几种可能：
GitHub 项目 golang-standards/project-layout 愿意更名，不再自称 ”golang-standards“，不过可能性比较低，因为已经已多人提出，但作者没什么表示。Go 官方正式提供 Go 标准项目布局的说明。Go 官方不做约束，仅做表态，可能输出文章。后续大家继续关注该提案，就可以知道发展了，传送门：issues #45861。
按照惯例，我猜测第三种可能性最大，因为很难有人可以提供所有开发者认可的标准，每个事业部、团队的喜好都可能有所不同。
总结实际上，任何东西自称 “XX 标准”，在名气大后，都会带来一些问题。就像本文提到的 golang-standards/project-layout 项目一样。
换位思考一下，若你是某个项目的 Leader，某一天你的同事，被人拿着 “标准” 来建议修改时，说这是这个项目的 “标准”，会不会很奇妙？
无独有偶，我有一个朋友，他们公司早年只有一套 DDD 标准，本想统一。结果后面每一个介入 DDD 的业务同学，都认为前人不标准，每个人都自创了一套 DDD 标准。
总是会有小伙伴想让定义绝对的 “标准”，又或是 “最佳实践”。其实是难以定义的，最好的就是能够一个团队内形成基本共识，这里面牵扯到的不单单只有技术...
你对此有什么看法呢，欢迎在评论区留言和大家一起交流！
若有任何疑问欢迎评论区反馈和交流，最好的关系是互相成就，各位的点赞就是煎鱼创作的最大动力，感谢支持。
文章持续更新，可以微信搜【脑子进煎鱼了】阅读，回复【000】有我准备的一线大厂面试算法题解和资料。
本文 GitHub github.com/eddycjy/blog 已收录，欢迎 Star 催更。
php介绍
PHP即“超文本预处理器”，是一种通用开源脚本语言。PHP是在服务器端执行的脚本语言，与C语言类似，是常用的网站编程语言。PHP独特的语法混合了C、Java、Perl以及 PHP 自创的语法。利于学习，使用广泛，主要适用于Web开发领域。
Tags 标签
后端golangphp扩展阅读
隐藏apache版本信息
2018-09-30 10:56:15 []CentOS 6.5安装php5.6
2018-09-30 11:36:53 []PHP版ZIP压缩解压类库
2018-12-22 13:11:00 []CentOS7.2安装 PHP7.3.4 操作详细教程
2020-06-28 19:09:43 []PHP 设置脚本超时时间、PHP脚本内存限制设置
2020-06-28 19:09:43 []PHP 函数filesize获取文件大小错误，一直不变
2020-06-28 19:09:43 []Linux php: command not found
2020-02-05 01:30:13 []php 缓冲区 buffer 原理
2020-06-28 19:09:43 []PHP中三种设置脚本最大执行时间的方法
2020-06-28 19:17:34 []加个好友，技术交流
