本文永久链接 – https://tonybai.com/2025/10/04/the-software-essays-that-shaped-me

大家好，我是Tony Bai。

二十年前，一位年轻的程序员在还未踏入职场时，便开始沉浸于软件开发的博客文章与深刻思考之中。二十年后，他已成为一名资深工程师，回首望去，成千上万的文字中，只有寥寥数篇真正沉淀下来，如基石般塑造了他的思维方式和职业生涯。

这份由 Michael Lynch 精心筛选出的“思想塑造清单”，本身就是一次对软件工程领域永恒智慧的巡礼。清单中的每一篇文章，都如同一个思想的火种，点燃了关于工程文化、代码哲学、乃至技术选型的深刻辩论。

今天，也让我们重新打开这些经典，逐一剖析其中的智慧，看看它们在瞬息万变的当下，能为我们——尤其是追求简约与高效的 Go 开发者——带来怎样历久弥新的启示。

1. Joel 测试：衡量开发者幸福感的 12 条黄金标准

(“The Joel Test: 12 Steps to Better Code” by Joel Spolsky, 2000)

Joel Spolsky 的这 12 个问题，与其说是对代码质量的测试，不如说是一面镜子，映照出一家公司是否真正尊重开发者的时间和心智。二十多年过去了，这些问题依然是衡量一个工程团队成熟度的“试金石”。

1. Do you use source control? (你用源码控制吗？)
2. Can you make a build in one step? (你能一步构建吗？)
3. Do you make daily builds? (你每天都构建吗？)
4. Do you have a bug database? (你有 Bug 数据库吗？)
5. Do you fix bugs before writing new code? (你先修 Bug 再写新代码吗？)
6. Do you have an up-to-date schedule? (你有最新的排期吗？)
7. Do you have a spec? (你有需求规格说明吗？)
8. Do programmers have quiet working conditions? (程序员有安静的工作环境吗？)
9. Do you use the best tools money can buy? (你用钱能买到的最好工具吗？)
10. Do you have testers? (你有测试人员吗？)
11. Do new candidates write code during their interview? (新候选人在面试时会写代码吗？)
12. Do you do hallway usability testing? (你做“走廊可用性测试”吗？)

虽然“每日构建”在今天已被“持续集成”(CI) 所取代，“Bug 数据库”也演变成了 Jira 或 Linear，但其精神内核——减少摩擦、自动化、系统化地管理混乱——从未过时。对于 Go 开发者而言，go build 的一步构建、go test 的内置测试、以及强大的静态分析工具链，都是对“Joel 测试”精神的现代回应。当你评估一个团队或项目时，不妨在心中过一遍这 12 个问题，它的得分，往往比任何花哨的技术栈更能说明问题。

2. 解析，而非验证：用类型系统构建“安全默认”的代码

(“Parse, don’t validate” by Alexis King, 2019)

这篇文章的核心论点，对于任何一个使用静态类型语言（如 Go）的开发者来说，都具有革命性的意义：“每当你验证一段数据时，你应该将它转换成一个新的类型。”

传统（脆弱的）做法：

// 每次使用前，都得记得调用它
func validateUsername(username string) error { ... }

这种做法的问题在于，它将验证的责任推给了开发者。你必须在代码的每一个角落，都记得去调用 validateUsername，一旦遗漏，就可能导致安全漏洞或数据损坏。

“解析，而非验证”的哲学：

// 定义一个全新的、无法被随意创建的类型
type Username string

// 唯一的入口：一个“解析”函数，它在内部执行验证
func ParseUsername(raw string) (Username, error) {
    if err := validate(raw); err != nil {
        return "", err
    }
    return Username(raw), nil
}

// 后续的业务逻辑，只接受这个被“祝福”过的类型
func GreetUser(u Username) { ... }

这种模式利用类型系统，将安全检查从一种“需要开发者时刻牢记的纪律”，转变为一种“由编译器强制执行的保证”。一旦你有了一个 Username 类型的变量，你就拥有了一个不可辩驳的证明——它必然是合法的。这在 Go 中极易实现，通过创建新的具名类型，我们可以轻松地在代码中构建起一道道安全的“防火墙”，让非法状态根本没有机会存在。

3. 无银弹：正视软件开发的“本质复杂性”

(“No Silver Bullet” by Fred Brooks, 1986)

这篇来自《人月神话》作者的经典文章，将软件开发工作划分为两个核心部分：

• 本质复杂性 (Essential Complexity)：与问题领域本身固有的、不可简化的复杂逻辑作斗争。例如，设计一套复杂的保险计价公式。
• 偶然复杂性 (Accidental Complexity)：与工具、环境和实现细节作斗争。例如，处理内存泄漏、等待编译、配置构建系统。

Brooks 的核心论点是：过去几十年软件开发效率的巨大提升，主要来自于对“偶然复杂性”的削减。但无论工具如何发展，我们永远无法消除“本质复杂性”。因此，不存在任何能够带来数量级生产力提升的“银弹”。

这篇文章是对抗技术领域“炒作周期”的最佳解毒剂。无论是微服务、Serverless、还是当下的 AI，它们在很大程度上解决的都是“偶然复杂性”。Go 语言的诞生，其核心目标——极快的编译速度、简单的并发模型、自动的垃圾回收——本身就是对 C++ 等语言“偶然复杂性”的一次宣战。

Brooks 的理论让我们保持清醒：即使 AI 能为我们编写代码，但定义需求、设计系统、测试复杂交互这些“本质复杂性”的工作，依然是人类工程师不可替代的价值所在。

4. 选择的代价：为用户做明智的决定

(“Choices” by Joel Spolsky, 2000)

Joel Spolsky 敏锐地指出：“你每提供一个选项，就是在要求用户做一次决策。” 过多的选择，尤其是那些用户并不具备足够信息来做出的选择，会中断用户的心流，带来挫败感。

他以 Windows 98 中一个荒谬的帮助搜索设置为例，痛斥了将底层技术决策（如“最小化数据库大小”或“最大化搜索能力”）推给普通用户的设计懒政。

这个原则不仅适用于 GUI，更适用于我们编写的任何 API 和命令行工具。当你的函数需要一大堆配置参数时，问问自己：

• 这些选项真的都是必需的吗？
• 我是否可以根据大多数场景，提供一个明智的、开箱即用的默认行为？
• 对于必须暴露的选项，我能否通过 Go 的选项模式 (Options Pattern) 来组织它们，让简单的使用保持简单，让复杂的配置成为可能？

一个优秀的 API 设计者，应该是一个“仁慈的独裁者”，敢于为用户承担决策的责任，只在真正必要时，才将选择的权力交还给他们。

5. 兼容性是为用户，而非为程序

(“Application compatibility layers are there for the customer, not for the program” by Raymond Chen, 2010)

Raymond Chen 用一个尖刻的比喻，讽刺了那些期望操作系统为他们的旧软件提供无限向后兼容性的开发者。然而，文章作者 Michael Lynch 反思后认为，这个比喻的背后，其实蕴含着一个更深刻的用户行为洞察：用户永远会选择阻力最小的路径。

如果你发现用户在以一种“错误”但“有效”的方式使用你的系统（比如，依赖一个 Bug 来实现某个功能），那么你的责任不是嘲笑他们，而是去理解他们为何这么做，并提供一条更简单、更正确的路径来引导他们。

这条规则对我们如今进行API设计也是大有借鉴意义的，这意味着我们需要时刻保持同理心。如果你发布了一个有 Bug 的 v1 版本，并且发现大量用户已经围绕这个 Bug 构建了他们的系统，那么在 v2 版本中，简单地“修复”这个 Bug 可能会导致大规模的破坏。

一个更负责任的做法可能是：

1. 在 v2 中提供一个新的、行为正确的 API。
2. 保留 v1 的旧 API，但将其标记为废弃，并在文档中清晰地解释其错误行为和迁移路径。
3. （在 Go 1.26+ 中）甚至可以利用 //go:fix 指令，为用户提供自动化的迁移工具。

6. 不要在测试中引入逻辑

(“Don’t Put Logic in Tests” by Erik Kuefler, 2014)

我们通常被教导要在生产代码中遵循 DRY (Don’t Repeat Yourself) 原则。但 Erik Kuefler 指出，将这一原则盲目地应用到测试代码中，可能是一场灾难。

糟糕的测试：

// 为了“ DRY ”，我们拼接了 URL
assertEquals(baseUrl + "/u/0/photos", nav.getCurrentUrl());

这段代码隐藏了一个微小的 Bug（多了一个斜杠），因为它需要读者在脑中进行一次字符串拼接运算才能发现问题。

优秀的测试：

// 清晰、直白，一眼就能看出期望的结果
assertEquals("http://plus.google.com//u/0/photos", nav.getCurrentUrl());

虽然存在字符串冗余，但它的意图是一目了然的。

测试代码的首要目标是清晰性，而非优雅或无冗余。测试代码没有它自己的测试，验证其正确性的唯一方式就是人工审查。因此，一段好的测试，应该像一篇优秀的规格说明文档，让任何一个读者都能毫不费力地理解它在断言什么。在 Go 的表驱动测试 (Table-Driven Tests) 中，这一点体现得尤为重要：绝大多数情况下，输入和期望的输出应该被清晰地、并排地列出，而不是通过复杂的辅助函数动态生成。

7. 一点原生 JavaScript 就能做很多事

(“A little bit of plain Javascript can do a lot” by Julia Evans, 2020)

Julia Evans 曾分享了她从一个坚定的“前端框架拥护者”转变为“原生 JavaScript 爱好者”的心路历程。在饱受了 Angular, React, Vue 等框架带来的依赖问题和复杂性的折磨后，她决定尝试只用原生 JavaScript（现代的 ES2018 标准）来构建一个 Web 界面。

结果令她震惊：没有框架、没有构建步骤、没有 Node.js，她依然能完成 90% 的工作，而开发体验的“头痛程度”只有 5%。当出现运行时错误时，她看到的不再是经过压缩、转换的“天书”，而是她自己写的、清晰可辨的代码。

这篇文章是对现代软件开发中“框架至上”文化的一次有力反思。它提醒我们，在引入任何一个大型框架或库之前，都应该先问自己：我真的需要这个吗？标准库或语言本身的能力是否已经足够？

对于 Go 开发者而言，这种思想更是与语言的哲学不谋而合。Go 拥有一个极其强大的标准库（特别是 net/http），在许多场景下，你完全不需要引入像 Gin 或 Echo 这样的 Web 框架，就能构建出高性能、可维护的 Web 服务。

Julia 的经历鼓励我们，要敢于挑战对框架的“路径依赖”，重新审视并信任我们手中工具（无论是 JavaScript 还是 Go 标准库）的内建能力。有时候，最简单的解决方案，恰恰就在我们眼前。

8. 选择无聊的技术

(“Choose Boring Technology” by Dan McKinley, 2015)

这篇经典文章的标题本身，就是其全部智慧的浓缩。Dan McKinley 警告我们，在启动一个新项目时，要警惕那些闪亮、前沿、充满炒作的新技术的诱惑。

• 新技术：有未知的 Bug 和弱点，当你遇到问题时，社区可能还没有解决方案，你将孤立无援。
• “无聊”的技术（如 Postgres, Java, Go）：虽然有其自身的问题，但经过数十年（或多年）的实战检验，它们几乎所有可能遇到的问题，都有成熟的、有据可查的解决方案。

McKinley 提出了一个有趣的模型：每个公司都有三枚“创新代币” (innovation tokens)。如果你想在一个项目中使用一项未经充分验证的新技术，你就必须花掉一枚代币。请明智地使用它们。

Go 语言本身，在许多方面，已经成为了“无聊技术”的典范。它稳定、向后兼容、拥有强大的标准库和成熟的生态。当我们进行技术选型时，应该问自己：我们当前的核心问题，真的需要一个全新的、我们团队不熟悉的“闪亮新事物”来解决吗？还是说，用我们已经精通的“无聊”工具，就足以应对挑战？选择“无聊”，往往是通往项目成功最可靠的路径。

9. 我把自己锁在了数字生活之外

(“I’ve locked myself out of my digital life” by Terence Eden, 2022)

这篇文章以一个引人入胜的思想实验开场：如果一道闪电击中了你的房子，摧毁了你所有的电子设备，你将如何恢复你的数字生活？

作者 Terence Eden 意识到，尽管他有密码管理器、硬件密钥和多重备份，但所有这些安全措施的“入口”，都依赖于他手边的某个设备。如果所有设备同时被毁，他将无法访问密码管理器，也无法使用硬件密钥，从而陷入一个无法恢复的死循环。

这个故事迫使读者思考一个被我们常常忽略的问题：我们的灾难恢复计划，是否本身就依赖于那些可能会在灾难中一同消失的东西？

这篇文章的教训，超越了个人数字安全，直指系统设计的核心——韧性 (Resilience) 和 避免单点故障。

当我们设计一个分布式系统时，我们是否考虑过最坏的情况？

• 我们的备份恢复流程，是否依赖于某个中心化的、可能会一同宕机的认证服务？
• 我们的配置中心如果不可用，应用是否能以一种“降级”但仍可用的模式启动？
• 在多云或混合云部署中，我们的跨区域故障转移方案，是否隐藏了对某个单一 DNS 提供商或证书颁发机构的隐式依赖？

Terence 的故事提醒我们，真正的系统韧性，不仅仅是拥有备份和冗余，更是要反复审视和测试我们的恢复路径，确保在极端情况下，我们不会发现自己“被锁在门外”。

10. Bonus：Brad Fitzpatrick 论输入验证的“咆哮”

(Brad Fitzpatrick on parsing user input, 2009)

最后，是一段来自 Go 社区大神、Memcached 和 LiveJournal 的创造者 Brad Fitzpatrick 的“咆哮”，这段话源于一本访谈录《Coders at Work》。当被问及软件工程的伦理时，他将矛头直指糟糕的输入验证：

“我希望每个人在他们的信用卡表单上都能保持一致，让我TMD能输入空格或连字符。计算机很擅长移除那些狗屎。别告诉我该如何格式化我的数字。”

这段充满激情的“粗口”，完美地概括了一个核心的用户体验原则：宽进严出 (Be liberal in what you accept, be conservative in what you produce)。

作为 API 或 UI 的设计者，我们的责任是尽可能地减轻用户的负担。计算机是用来处理繁琐、重复性工作的。如果用户输入了一个带空格的电话号码，或者一个全角的逗号，我们的程序应该默默地、智能地将其清理和格式化，而不是粗暴地拒绝并抛出一个错误。

Fitzpatrick 的“咆哮”时刻提醒着我们：每一次当你设计一个输入字段时，都要站在用户的角度思考，并记住那句话——“计算机很擅长移除那些狗屎。”

小结：构建衡量“好”与“坏”的永恒坐标系

从 Joel Spolsky 对工程文化的拷问，到 Fred Brooks 对复杂性的深刻剖析；从 Alexis King 对类型安全的精妙论证，到 Dan McKinley 对技术选型的务实忠告…… 当我们跟随 Michael Lynch 的脚步，完成这次跨越四十年的思想巡礼后，我们收获的远不止是一份“书单”。

技术浪潮来了又去，今天我们手中的工具，明天可能就会过时。但这些围绕着“人”的根本原则——清晰性、简单性、健壮性、同理心、风险意识——却是永恒的。它们是区分一名普通的“代码实现者”与一位真正的“软件工程师”的分水岭。

这份清单，最终为我们构建的，是一个内心深处的、用以衡量“好”与“坏”的永恒坐标系。在未来的职业生涯中，无论面对何种炫目的新技术或棘手的工程问题，这个坐标系都将指引我们，做出更明智、更持久、也更具价值的决策。

资料链接：https://refactoringenglish.com/blog/software-essays-that-shaped-me

你的Go技能，是否也卡在了“熟练”到“精通”的瓶颈期？

• 想写出更地道、更健壮的Go代码，却总在细节上踩坑？
• 渴望提升软件设计能力，驾驭复杂Go项目却缺乏章法？
• 想打造生产级的Go服务，却在工程化实践中屡屡受挫？

继《Go语言第一课》后，我的《Go语言进阶课》终于在极客时间与大家见面了！

我的全新极客时间专栏 《Tony Bai·Go语言进阶课》就是为这样的你量身打造！30+讲硬核内容，带你夯实语法认知，提升设计思维，锻造工程实践能力，更有实战项目串讲。

目标只有一个：助你完成从“Go熟练工”到“Go专家”的蜕变！ 现在就加入，让你的Go技能再上一个新台阶！

想系统学习Go，构建扎实的知识体系？

我的新书《Go语言第一课》是你的首选。源自2.4万人好评的极客时间专栏，内容全面升级，同步至Go 1.24。首发期有专属五折优惠，不到40元即可入手，扫码即可拥有这本300页的Go语言入门宝典，即刻开启你的Go语言高效学习之旅！

商务合作方式：撰稿、出书、培训、在线课程、合伙创业、咨询、广告合作。如有需求，请扫描下方公众号二维码，与我私信联系。

本文永久链接 – https://tonybai.com/2025/09/26/self-reliant-programmer

大家好，我是Tony Bai。

“当代多数软件，对其用户而言是一种耻辱。”

最近，一篇措辞激烈、观点鲜明的《自立程序员宣言》（Self-Reliant Programmer Manifesto）在技术圈流传开来。它以一种近乎愤怒的姿态，抨击了现代软件开发中日益增长的复杂性、对臃肿工具的过度依赖以及脆弱的供应链。

对于许多沉浸在复杂框架和无尽工具链中的开发者来说，这份宣言可能显得有些“原教旨主义”。然而，在我们Go社区，当这篇文章被转发和讨论时，一种奇特的、会心一笑的共鸣油然而生。我们中的许多人看完后的第一反应是：“这不就是我们一直在说的Go语言哲学吗？”

这份宣言的核心呼吁——相信简单、最小化依赖、并勇于编写自己的工具——听起来就像是Go社区日常交流的“黑话”。

本文将和你一起解读这份“檄文”，并逐一印证，为什么它所倡导的“自立”之道，早已深深烙印在Go语言的DNA之中。

Go语言哲学：我们一直在坚持什么？

在解读宣言之前，让我们先回顾一下Go社区长期以来所珍视的一些核心价值观：

• 少即是多 (Less is exponentially more)：Go语言刻意保持规范的微小，避免引入带有额外认知负荷的特性。
• 清晰优于聪明 (Clear is better than clever)：代码首先是写给人读的，显式的错误处理、简单的控制流远比“魔法般”的语法糖更受推崇。
• “自带电池” (Batteries Included)：一个强大的标准库，是我们抵御外部依赖泛滥的第一道，也是最重要的一道防线。
• “一点复制胜过一点依赖” (A little copying is better than a little dependency)：这句社区谚语，体现了我们对引入新依赖的极度审慎。

现在，让我们带着这些“Go味十足”的理念，去看看《自立程序员宣言》都说了些什么。

宣言的核心法则 vs. Go的内在基因

法则一：“简单即是善” (Simple is good)

宣言说：“一切复杂的事物，都是由简单的东西构成的……你不需要四十二层抽象来实现一些简单的事情。”

这不就是我们所说的“少即是多”吗？ Go的设计哲学正是建立在对“简单性”的极致追求之上。它通过减少语言特性，来降低程序员的心智负担。当你在阅读一段Go代码时，你很少需要去猜测这段代码背后隐藏着什么复杂的继承链或元编程魔法。你所见即所得。

宣言强调：“理解事物的工作原理能帮助你建立更好的心智模型。” Go的显式错误处理 (if err != nil)虽然常被诟病冗长，但它强迫我们直面每一个可能出错的环节，而不是将其隐藏在try-catch的便利之下。这正是帮助我们建立健壮心智模型的绝佳实践。

法则二：“最小化依赖” (Minimises their dependencies)

宣言说：“更少的依赖意味着更少被包管理器的供应链攻击所伤害……更简单的代码意味着更好地理解你实际在使用的东西。”

这不就是我们“自带电池”和“一点复制胜过一点依赖”的实践吗？ Go强大的标准库，让我们在构建高性能Web服务、处理并发、加解密等无数场景下，都无需第一时间就去go get一个外部模块。

当确实需要外部功能时，社区文化也鼓励我们保持克制。与其为了一个简单的辅助函数就引入一个庞大的库及其数十个传递依赖，我们更倾向于将那几行代码直接复制到自己的项目中。这看似“原始”，却完美地践行了宣言的精神：完全掌控你自己的代码，并深刻理解它的每一行。

法则三：“编写自己的工具” (Writes their own tools)

宣言说：“更简单的工具意味着你可以独自工作……你无需依赖臃肿的CI、Docker、Kubernetes……”

这不就是Go语言被创造出来的核心目的之一吗？Go本身就是一门为构建工具和基础设施而生的语言。

• 静态编译与单二进制文件：go build产生的单一静态二进制文件，是分发和部署工具的终极形态。没有运行时依赖，没有复杂的安装脚本。
• 云原生世界的基石：Docker, Kubernetes, Terraform, Prometheus, etcd……这些定义了现代基础设施的工具，几乎无一例外都是用Go编写的。

我们Gopher不仅用Go构建应用，更用Go构建了我们赖以工作的整个世界。我们不满足于使用别人提供的、充满黑盒的工具，我们选择用我们自己的语言，为我们自己打造称手的兵器。这正是“自立程序员”精神的最高体现。

“自立”，是Go赋予我们的底气

宣言中提到：“你无需请求任何人的祝福去做你需要做的任何事。你只需坐下来，写代码，解决问题。”

Go语言，通过其独特的设计，赋予了我们这种“说干就干”的底气。

• 因为Go的单二进制特性，我们的部署可以简单到只是一条scp命令，而不必被复杂的容器编排工具链所绑架。
• 因为Go的跨平台编译能力，我们可以在一台机器上为所有目标平台构建工具，而不依赖复杂的CI矩阵。
• 因为Go的性能足够好，我们很少需要为了性能而被迫引入C/C++库，从而避免了CGo带来的复杂性和依赖问题。

这种底层的简单性和强大的能力，让我们在面对现代工具链的复杂性时，始终保有一个“退路”。我们可以选择拥抱Kubernetes的强大，也可以在需要时，从容地回归到最原始、最可靠的部署方式。我们是工具的主人，而非奴隶。

小结：是的，这正是我们的哲学

《自立程序员宣言》对我们Gopher而言，与其说是一份需要学习的新思想，不如说是一面镜子，映照出了我们社区长期以来所珍视和践行的价值观。

它用一种更富激情、更具煽动性的语言，将Go语言的哲学内核大声地宣告了出来。是的，我们相信简单，我们警惕依赖，我们热衷于构建自己的工具。

因为在Go的世界里，“自立”不是一种遥不可及的理想，而是我们通过语言和工具，每天都在实践的日常。这份宣言，是对所有Gopher选择的道路的一次响亮的回应和肯定。

资料链接：https://yobibyte.github.io/self_reliant_programmer.html

你的Go技能，是否也卡在了“熟练”到“精通”的瓶颈期？

• 想写出更地道、更健壮的Go代码，却总在细节上踩坑？
• 渴望提升软件设计能力，驾驭复杂Go项目却缺乏章法？
• 想打造生产级的Go服务，却在工程化实践中屡屡受挫？

继《Go语言第一课》后，我的《Go语言进阶课》终于在极客时间与大家见面了！

我的全新极客时间专栏 《Tony Bai·Go语言进阶课》就是为这样的你量身打造！30+讲硬核内容，带你夯实语法认知，提升设计思维，锻造工程实践能力，更有实战项目串讲。

目标只有一个：助你完成从“Go熟练工”到“Go专家”的蜕变！ 现在就加入，让你的Go技能再上一个新台阶！

商务合作方式：撰稿、出书、培训、在线课程、合伙创业、咨询、广告合作。如有需求，请扫描下方公众号二维码，与我私信联系。