Skip to content

Commit 00176ef

Browse files
committed
review part 1
1 parent 08ef8c8 commit 00176ef

File tree

1 file changed

+6
-26
lines changed

1 file changed

+6
-26
lines changed

README.md

Lines changed: 6 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
# 代码整洁的 JavaScript
22

33
## 目录
4+
45
1. [简介](#简介)
56
2. [变量](#变量)
67
3. [函数](#函数)
@@ -15,48 +16,27 @@
1516
12. [Translation](#translation)
1617

1718
## 简介
18-
![一张用你阅读代码时吐槽的数量来评估软件质量的搞笑图片](http://www.osnews.com/images/comics/wtfm.jpg)
1919

20-
Software engineering principles, from Robert C. Martin's book
21-
[*Clean Code*](https://www.amazon.com/Clean-Code-Handbook-Software-Craftsmanship/dp/0132350882),
22-
adapted for JavaScript. This is not a style guide. It's a guide to producing
23-
readable, reusable, and refactorable software in JavaScript.
20+
![一张用你阅读代码时吐槽的数量来评估软件质量的搞笑图片](http://www.osnews.com/images/comics/wtfm.jpg)
2421

2522
将源自 Robert C. Martin 的 [*Clean Code*](https://www.amazon.com/Clean-Code-Handbook-Software-Craftsmanship/dp/0132350882)
26-
的软件工程原则适配到 JavaScript 。 这不是一个代码风格指南, 它是一个用 JavaScript 来生产可
27-
读的, 可重用的, 以及可重构的软件的指南。
28-
29-
Not every principle herein has to be strictly followed, and even fewer will be
30-
universally agreed upon. These are guidelines and nothing more, but they are
31-
ones codified over many years of collective experience by the authors of
32-
*Clean Code*.
23+
的软件工程原则适配到 JavaScript 。 这不是一个代码风格指南, 它是一个使用 JavaScript 来生产
24+
可读的, 可重用的, 以及可重构的软件的指南。
3325

3426
这里的每一项原则都不是必须遵守的, 甚至只有更少的能够被广泛认可。 这些仅仅是指南而已, 但是却是
3527
*Clean Code* 作者多年经验的结晶。
3628

37-
Our craft of software engineering is just a bit over 50 years old, and we are
38-
still learning a lot. When software architecture is as old as architecture
39-
itself, maybe then we will have harder rules to follow. For now, let these
40-
guidelines serve as a touchstone by which to assess the quality of the
41-
JavaScript code that you and your team produce.
42-
4329
我们的软件工程行业只有短短的 50 年, 依然有很多要我们去学习。 当软件架构与建筑架构一样古老时,
4430
也许我们将会有硬性的规则去遵守。 而现在, 让这些指南做为你和你的团队生产的 JavaScript 代码的
4531
质量的标准。
4632

47-
One more thing: knowing these won't immediately make you a better software
48-
developer, and working with them for many years doesn't mean you won't make
49-
mistakes. Every piece of code starts as a first draft, like wet clay getting
50-
shaped into its final form. Finally, we chisel away the imperfections when
51-
we review it with our peers. Don't beat yourself up for first drafts that need
52-
improvement. Beat up the code instead!
53-
5433
还有一件事: 知道这些指南并不能马上让你成为一个更加出色的软件开发者, 并且使用它们工作多年也并
55-
不意味着你不会犯错误。 每一段代码最开始都是草稿, 像湿粘土一样被打造成最终的形态。 最后当我们
34+
不意味着你不再会犯错误。 每一段代码最开始都是草稿, 像湿粘土一样被打造成最终的形态。 最后当我们
5635
和搭档们一起审查代码时清除那些不完善之处。 不要因为最初需要改善的草稿代码而自责, 而是对那些代
5736
码下手。
5837

5938
## **变量**
39+
6040
### 使用有意义并且可读的变量名称
6141

6242
**不好的:**

0 commit comments

Comments
 (0)
pFad - Phonifier reborn

Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.

Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.


Alternative Proxies:

Alternative Proxy

pFad Proxy

pFad v3 Proxy

pFad v4 Proxy