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