代码简洁性
理解软件
2017年10月10日 by Max Kanat-Alexander
大家好！我出版了一本新书！书名是《理解软件》。
这本书收录了我自《代码简洁性》出版以来关于软件开发和团队合作的所有文章，还包含一些从未在任何地方发表过的全新内容。实际上，书中包含了我2008年写的一篇最喜欢的文章，但之前从未发表过。
所有内容都经过了精美的排版设计，经过精心策划和组织，以达到最佳的可读性。我对这本书非常满意，期待听到大家的反馈。
出版社介绍
《理解软件》涵盖了编程的许多领域，从如何编写简单代码到对编程的深刻见解，再到如何在你所做的工作中少犯错！
你将发现软件复杂性的问题、其根本原因，以及如何运用简洁性来创建优秀的软件。你将以前所未有的方式审视调试，以及如何在团队合作中保持快乐。
Max从他传奇的博客"代码简洁性"中精选了一系列精心撰写的文章、思考和建议，关于如何在软件行业工作和取得成功。Max精心撰写了43篇文章，这些文章有能力帮助你避免复杂性、拥抱简洁性，从而成为更快乐、更成功的开发者。
Max的技术知识、洞察力和善良为他赢得了代码大师的地位，他的想法将激励你，并帮助刷新你应对开发者挑战的方法。
你将学到什么
- 了解如何为你的编程世界带来简洁和成功
- 复杂性的线索 - 以及如何构建优秀的软件
- 简洁性与软件设计
- 程序员的原则
- 摇滚明星程序员的秘密
- Max对软件行业的观点和解读
- 为什么程序员会犯错以及如何少犯错
- 用两句话说明软件设计
- 什么是bug？
- 深入调试
你可以在亚马逊、直接从出版商或任何其他销售编程书籍的地方购买。
-Max
读者评论
Saim Aksr 说： 2017年10月19日下午5:27 有趣的文章，代码应该始终保持干净且可被其他开发者阅读。
Urvish S 说： 2018年12月11日上午12:11 这对软件开发领域的新手将是很大的支持。
Dig in and create you own parser library – Tech Musings By Dave 说： 2024年1月3日下午12:24 […] Max Kanat Alexandar的《理解软件》是一本超级快速的读物，应该成为任何新开发者（工程师）的必读材料。它为你提供了简单的指导原则和解决问题的方法。书中有一部分在一年前左右一直在我耳边回响：“优秀的开发者阅读每一行代码”。我以前从未考虑过这一点。就像对于你支持的应用/公司，你应该理解生产环境中运行的每一行代码。这包括你正在使用的第三方库。[…]
近期思考
9月17日
一般来说，解决软件系统问题的方法是分配软件工程师来解决问题。
将问题分配给软件工程师的危险在于，他们会编写软件来解决它。
当你看到软件系统中长期未解决的问题时，通常意味着没有人被分配去解决那个具体问题。
当你看到不必要的软件被编写时，几乎总是因为软件工程师被分配去解决某个问题，并决定编写软件是解决方法。
7月28日
非常兴奋地宣布，我将在2025年开发者生产力工程峰会上发表主题演讲之一。我将谈论什么造就了优秀的开发者体验。
我自1995年以来一直在技术领域工作，自2004年以来几乎全职专注于开发者体验。关于如何使开发者体验变得优秀，存在某些基本的、普遍的真理，我将在有限的时间内尽可能多地涵盖这些内容。
很希望在那里见到你。:)
6月27日
我目前认为，AI代理能够成功生成的输出数量和质量取决于：
- 模型的质量
- 代理的质量
- 输入的质量（如提示或其他上下文）
- 代理可以独立运行的确定性、客观验证的质量
我目前认为，除非你是模型开发者，否则最重要的部分是"确定性、客观验证"。
简单来说，如果你告诉AI做某事，它需要某种方式能够自行验证它做对了。在软件中，这通常意味着运行测试、linter等，如果系统做错了就会失败。
这意味着你的测试和验证工具越好，你从模型获得的输出就越好。这不仅仅是测试数量的问题。它们必须是好的测试，具有智能断言和良好的错误消息。
这也意味着代理的成功涉及思考如何将任务分解成可以分别通过自动化测试、linter等进行客观验证的独立部分。
需要注意的是，输入的质量也很重要，并且在我们的控制之下。如果我们编写更好的文档和更清晰的代码，代理会表现得更好。令人惊讶的是，几乎所有帮助人类编写代码的东西也帮助代理。
6月4日
技术债务有价值的想法大多是个神话。当你做出糟糕的软件工程决策时，它会在几小时、几天或几周内减慢你的速度。这是上限。
许多人认为需要数月或数年才能看到在软件设计上偷工减料的影响，但这根本不是真的。它几乎立即开始。
做正确的事情的成本通常是几个小时，也许一天，而你几乎总是立即收回那个时间。也就是说，做对通常花费的时间与做错花费的时间相同。
“等等，什么？这怎么可能？我们偷工减料是为了节省时间！“结果几乎总是它根本没有为你节省时间！它使处理变更更加混乱。它使代码审查时间更长。它在测试期间以更混乱的方式失败，需要更长时间来调试。它几乎从不节省你的实际时间。
偶尔，你的路径中会有一些如此巨大的"岩石”，你根本无法移动它。没有人应该花三个月设计一个新工具，只是为了你能一次性地交付一个一天的功能。但这只是技术债务决策中极小的一部分。
这变得更加疯狂，因为如果你在过程中把所有事情都做对（你总是重构系统，使其看起来像是被设计成现在所做的 exactly），那么一切在整个过程中都保持相对容易。但如果你偷工减料，一切都会变得复合性地更加困难，以至于你生成了没有人能移动的"岩石”。复杂性不是某种线性的东西，你可以后来投入线性时间修复。你绝对可能陷入一种如此糟糕的境地，以至于你公司中没有人有时间或专业知识来修复它。
这一切感觉如此无辜：“让我们偷工减料吧，它会帮助我们满足这个截止日期”（这个截止日期通常是虚构的，你可以推迟几周而没有任何后果）。“很难弄清楚如何正确地做这个，我们能推迟吗？“然后砰，很快你发现自己陷入了一个沼泽，一切都很难，而且"我们不知道为什么！”
我最后留给你一件事：当我每天直接编码时，我在这方面是完全不妥协的。我基本上无法忍受糟糕的代码 - 我必须重构它，否则我无法工作。而不知何故，在我整个职业生涯的那部分中，我从未错过任何一个截止日期。