2018-10-10 22:03:03 +00:00
|
|
|
---
|
|
|
|
id: bd7123c9c441eddfaeb4bdef
|
2021-03-15 03:20:39 +00:00
|
|
|
title: 给代码添加注释
|
2018-10-10 22:03:03 +00:00
|
|
|
challengeType: 1
|
2020-04-29 10:29:13 +00:00
|
|
|
videoUrl: 'https://scrimba.com/c/c7ynnTp'
|
|
|
|
forumTopicId: 16783
|
2021-01-13 02:31:00 +00:00
|
|
|
dashedName: comment-your-javascript-code
|
2018-10-10 22:03:03 +00:00
|
|
|
---
|
|
|
|
|
2020-12-16 07:37:30 +00:00
|
|
|
# --description--
|
|
|
|
|
2021-03-15 03:20:39 +00:00
|
|
|
被注释的代码块在 JavaScript 之中是不会执行的。 在代码中写注释,是一个可以让你自己和以后的其他人理解代码作用的好方法。
|
2020-12-16 07:37:30 +00:00
|
|
|
|
2021-03-15 03:20:39 +00:00
|
|
|
JavaScript有两种写注释的方法。
|
2020-12-16 07:37:30 +00:00
|
|
|
|
2021-03-15 03:20:39 +00:00
|
|
|
使用 `//` 注释掉当前行的代码。 这是一个行内注释:
|
2020-04-29 10:29:13 +00:00
|
|
|
|
|
|
|
```js
|
|
|
|
// This is an in-line comment.
|
|
|
|
```
|
|
|
|
|
2021-03-15 03:20:39 +00:00
|
|
|
你也可以使用多行注释来注释你的代码,使用 `/*` 开始, `*/` 结束. 这是一个多行注释:
|
2020-04-29 10:29:13 +00:00
|
|
|
|
|
|
|
```js
|
|
|
|
/* This is a
|
|
|
|
multi-line comment */
|
|
|
|
```
|
|
|
|
|
2021-03-15 03:20:39 +00:00
|
|
|
**最佳实践**当你写代码的时候,你应该时不时的添加注释来解释你写的代码的作用。 适当的注释能让别人*和*你未来的自己更容易看懂代码。
|
2018-10-10 22:03:03 +00:00
|
|
|
|
2020-12-16 07:37:30 +00:00
|
|
|
# --instructions--
|
2018-10-10 22:03:03 +00:00
|
|
|
|
2021-03-15 03:20:39 +00:00
|
|
|
尝试创建这两种类型的注释。
|
2018-10-10 22:03:03 +00:00
|
|
|
|
2020-12-16 07:37:30 +00:00
|
|
|
# --hints--
|
2018-10-10 22:03:03 +00:00
|
|
|
|
2021-03-15 03:20:39 +00:00
|
|
|
创建一个 `//` 样式的注释,被注释的文本至少要包含 5 个字符。
|
2018-10-10 22:03:03 +00:00
|
|
|
|
|
|
|
```js
|
2020-12-16 07:37:30 +00:00
|
|
|
assert(code.match(/(\/\/)...../g));
|
2018-10-10 22:03:03 +00:00
|
|
|
```
|
|
|
|
|
2021-03-15 03:20:39 +00:00
|
|
|
创建一个 `/* */` 样式的注释,被注释的文本至少要包含 5 个字符。
|
2020-04-29 10:29:13 +00:00
|
|
|
|
2018-10-10 22:03:03 +00:00
|
|
|
```js
|
2020-12-16 07:37:30 +00:00
|
|
|
assert(code.match(/(\/\*)([^\/]{5,})(?=\*\/)/gm));
|
2018-10-10 22:03:03 +00:00
|
|
|
```
|
2020-04-29 10:29:13 +00:00
|
|
|
|
2021-01-13 02:31:00 +00:00
|
|
|
# --seed--
|
|
|
|
|
|
|
|
## --seed-contents--
|
2021-03-15 03:20:39 +00:00
|
|
|
|
2021-01-13 02:31:00 +00:00
|
|
|
```js
|
2021-03-15 03:20:39 +00:00
|
|
|
|
2021-01-13 02:31:00 +00:00
|
|
|
```
|
|
|
|
|
2020-12-16 07:37:30 +00:00
|
|
|
# --solutions--
|
|
|
|
|
2021-01-13 02:31:00 +00:00
|
|
|
```js
|
|
|
|
// Fake Comment
|
|
|
|
/* Another Comment */
|
|
|
|
```
|