diff --git a/1-js/02-first-steps/02-structure/article.md b/1-js/02-first-steps/02-structure/article.md index 7b5c702fd7..0599ca29e0 100644 --- a/1-js/02-first-steps/02-structure/article.md +++ b/1-js/02-first-steps/02-structure/article.md @@ -61,7 +61,7 @@ alert(3 + 不需要考虑方括号 `[]` 和 `forEach` 的含义,我们接下来会学习它们,现在它们并不重要。让我们记住最终结果:先显示 `1`,然后显示 `2`。 -现在我们在代码前面加入一个 `alert`,并且不用分号结束它。 +现在我们在代码前面加入一个 `alert`,并且不用分号结束它: ```js run no-beautify alert("There will be an error") @@ -83,7 +83,7 @@ alert("All fine now"); 出现无分号变量的错误,是因为 JavaScript 并不在方括号 `[...]` 前添加一个隐式的分号。 -所以,因为分号并不会自动插入,第一个例子被视为一条简单的语句,我们从引擎看到的是这样子的: +所以,因为分号并不会自动插入,第一个例子中的代码被视为一条简单的语句,我们从引擎看到的是这样子的: ```js run no-beautify alert("There will be an error")[1, 2].forEach(alert) @@ -92,13 +92,13 @@ alert("There will be an error")[1, 2].forEach(alert) 但它应该是两条语句,而不是一条。这种情况下的合并是不对的,所以才会造成错误。诸如此类,还有很多。 ```` -如果语句被换行分割,非常建议在语句之间添加分号。这个规则被社区广泛采纳。让我们再次强调 —— 大部分时候可以省略分号,但是最好是,尤其对于新手,加上它。 +即使语句被换行符分隔了,我们依然建议在它们之间加分号。这个规则被社区广泛采纳。让我们再次强调 —— 大部分时候可以省略分号,但是最好是,尤其对于新手,加上它。 ## 注释 -随着时间推移,程序变得越来越复杂。为代码添加**注释**来描述发生了什么(What happens)和为什么(Why),变得非常有必要了。 +随着时间推移,程序变得越来越复杂。为代码添加**注释**来描述它做什么和为什么(要这样做),变得非常有必要了。 -注释可以在脚本的任何地方添加,它们并不会影响代码的执行,因为引擎会简单地忽略它们。 +注释可以在脚本的任何地方添加,它们并不会影响代码的执行,因为引擎会直接忽略它们。 **单行注释以两个正斜杠字符 `//` 开始。** @@ -156,4 +156,4 @@ alert( 'World' ); 注释会增加代码总量,但这一点也不是问题。有很多工具可以在你部署到服务器之前缩减代码。这些工具会移除注释,所以注释不会出现在发布的脚本中。所以,注释对我们的生产没有任何负面影响。 -在进一步的教程中,会有一章 的内容解释如何书写更好的注释。 +在进一步的教程中,会有一章 的内容解释如何书写更好的注释。