摘自《The Clean Coder》

2025-06-07

摘自《The Clean Coder》

在yos.io上查找更多有趣的文章

成为一名真正的软件工匠意味着什么?

以下是我从《The Clean Coder》(专业程序员的行为准则)中总结出的要点。

不伤害

软件太复杂了,不可能创建出没有缺陷的软件。

然而,即使错误几乎不可避免,你也必须为错误负责。道歉是必要的,但仅仅道歉是不够的。你不能一遍又一遍地犯同样的错误。随着你职业生涯的成熟,你的错误率应该迅速下降到零。你有责任尽可能地接近零。

QA 应该不会发现任何异常。

有些人把 QA 当作 bug 捕获者。他们把没有经过彻底检查的代码发给他们。这种行为纯粹是懒惰和不负责任的。发布自己都不知道是否有效的代码,非常不专业。

你必须知道它有效。

测试一下。再测试一下。

每当QA发现问题时,开发团队都应该感到震惊。他们应该反思问题是如何发生的,并采取措施防止将来再次发生。

职业道德

确保你具备市场竞争力不是你的雇主的责任。培训你、送你去参加会议或给你买书也不是你的雇主的责任。这些都是你自己的责任。

你应该计划每周工作60个小时。前40个小时是为你的雇主工作,剩下的20个小时是给自己工作。在这剩下的20个小时里,你应该阅读、练习、学习,并通过其他方式提升你的职业生涯。

指导

最好的学习方式就是教导。没有什么比将事实和价值观传达给你所负责的人更能快速有效地将之铭刻你的脑海。

好代码

  1. 首先,你的代码必须能够正常工作。你必须理解你正在解决的问题,并了解如何解决这个问题。你必须确保你编写的代码忠实地体现了该解决方案。你必须管理该解决方案的每一个细节,同时保持与语言、平台、当前架构以及当前系统的所有缺陷的一致性。

  2. 你的代码必须解决客户提出的问题。客户的需求往往并不能真正解决客户的问题。你必须认识到这一点,并确保满足客户的真正需求。

  3. 你的代码必须与现有系统完美契合。它不应增加系统的僵化、脆弱性或不透明性。简而言之,你的代码需要遵循可靠的工程原则。

  4. 你的代码必须易于其他程序员阅读。这要求你精心设计代码,使其能够展现你的意图。这可能是程序员最难掌握的一点。

凌晨 3 点代码

当你无法充分集中精力时,你写的代码就会出错。它会有 bug,结构也会错误,晦涩难懂,无法解决客户的实际问题。简而言之,它必须返工或重做。分心工作会造成浪费。

虚假交付

作为一名程序员,最糟糕的事情就是当你知道事情还没有完成时就说你已经完成了。

求人

学会寻求帮助。当你遇到困难、困惑,或者无法理解某个问题时,一定要向别人寻求帮助。这关乎职业道德。明明可以随时获得帮助,却依然束手无策,这是不专业的。

协作对于有效编程至关重要。

团队合作

作为一名专业人士,你的职责是帮助你的团队开发出最好的软件。每个人都需要留意错误和失误,并齐心协力纠正它们。

会议

明智地利用你的时间。

当您收到会议邀请时,请不要接受,除非该会议对于您现在所做的工作具有立即且重大的必要性。

会议无聊的时候就离开。你有义务管理好自己的时间。

站立会议

  1. 我昨天做了什么?
  2. 我今天要做什么?
  3. 什么阻碍了我?

每个问题不应超过二十秒。

优先事项

专业人员会评估每项任务的优先级,忽略个人的恐惧和愿望,并按优先顺序执行这些任务。

沼泽

专业人士对混乱的恐惧远胜于对死胡同的恐惧。他们时刻警惕着那些开始无限蔓延的混乱,并会竭尽全力,尽早、尽快地摆脱它们。

尽可能保持您的系统、代码和设计清洁。

承诺

专业软件开发人员不会做出无法兑现的承诺,也不会做出不确定能否兑现的承诺。

工艺

工匠做事迅速但不急躁,给出合理预算并履行承诺。工匠知道何时说“不”,但会努力做到“是”。

在yos.io上查找更多有趣的文章

文章来源:https://dev.to/yos/excerpts-from-the-clean-coder--2ddb
PREV
Schema-First API 设计 Schema-first API 设计 API 规范语言 OpenAPI 规范语言 结束语 附录
NEXT
您是如何决定自己想做什么的?