From 30d7fcba3a787e7a150dffc53393550569688e3c Mon Sep 17 00:00:00 2001 From: Seamile Date: Tue, 18 Apr 2023 15:22:23 +0800 Subject: [PATCH] docs: fix typo (#11) --- docs/clean-code.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/clean-code.md b/docs/clean-code.md index 206a290..834eaee 100644 --- a/docs/clean-code.md +++ b/docs/clean-code.md @@ -15,7 +15,7 @@ 1. 函数的第一规则是要短小。第二条规则是还要更短小...经过漫长的试错，经验告诉我，函数就该小。 1. 函数应该做一件事。做好这件事。只做这一件事。判断函数是否不止做了一件事，有一个方法，就是看是否能再拆出一个函数，该函数不仅只是单纯地重新诠释其实现。 1. 要确保函数只做一件事，函数中的语句都要在同一抽象层级上。函数中混杂不同的抽象层级，往往让人迷惑。读者可能无法判断某个表达式是基础概念还是细节。更恶劣的是，就像破损的窗户，一旦细节与基础概念混杂，更多的细节就会在函数中纠结起来。 -1. 写出短小的 `switch` 语句往往很难。写出只做一件事的 `switch` 语句也很难。我们总不发避开 `switch` 语句，不过还是能够确保 `switch` 都埋藏在较低的抽象层级，而且永远不重复。 +1. 写出短小的 `switch` 语句往往很难。写出只做一件事的 `switch` 语句也很难。我们总无法避开 `switch` 语句，不过还是能够确保 `switch` 都埋藏在较低的抽象层级，而且永远不重复。 1. 最理想的参数数量是零，其次是一，再次是二...从测试的角度看，参数甚至更叫人为难。想想看，要编写能确保参数的各种组合运行正常的测试用例，是多么困难的事。如果没有参数，就是小菜一碟。 1. 函数承诺只做一件事，但还是会做其它被藏起来的事。有时，它会对自己类中的变量做出未能预期的改动，导致古怪的时序性耦合及顺序依赖。