
28
|
第
4
章
项目的文件与目录该如何安排,很大程度上由你自己决定。推荐在
README.md
文件(或
从它链接到的自述文件)里加上项目文件与目录的导航。
建议项目根目录至少包含
package.json
和
README.md
这两个文件。其余的取决于你的想象力。
4.2
最佳实践
最佳实践
如今是个热词,你应该有所耳闻。它意味着应该“把事情做对”,并且不能取巧
(一会儿再专门讨论其具体含义)。你应该听说过下面这句工程建设格言:可以又快、又
省、又好,但只能选择其中两样。我常常对此“教条”感到不满:它没有考虑使用正确方
式做事的
累积价值
。第一次使用正确的方式做某件事,可能要花比“只求快而不计后果”
的做法多
4
倍的时间
。可是到了第二次,只要花
3
倍的时间,而十几次之后,就可以跟
“只求快而不计后果”的做法一样快了。
一位击剑教练曾告诫我说:练习未必达成完美,它只是在
固化
。也就是说,如果你一遍遍
地做某事,最终就会形成无意识的机械行为。这句话是对的,但它忽略了练习的质量。如
果你不断练习的是坏习惯,那么坏习惯就会机械化。因此,应该遵守“完美的练习才能达
成完美”的法则。我鼓励你在此法则的指引下跟随本书后面的示例代码,就好像在构建一
个真实的网站,且你的声誉和收入都依赖这个网站的质量。使用本书的目的,不应该只是
学习新技能,而是通过练习,养成一些好习惯。
我们将主要关注版本控制和质量保证(
QA
)方面的实践
。本章会讨论版本控制,
QA
将在
下一章讨论。
4.3
版本控制
希望不需要我来告诉你版本控制的重要性(否则恐怕得再写一本书)。大体来说 ...