二维码

JavaScript 注释

JavaScript注释


JavaScript 注释可用于解释 JavaScript 代码,并使其更具可读性。

在测试替代代码时,JavaScript 注释也可用于阻止执行。


单行评论

单行注释以//.

JavaScript 会忽略该行之间和行尾之间的任何文本//(不会执行)。

此示例在每个代码行之前使用单行注释:

1
2
3
4
5
// Change heading:  
document.getElementById("myH").innerHTML = "My First Page";

// Change paragraph:
document.getElementById("myP").innerHTML = "My first paragraph.";

此示例在每行末尾使用单行注释来解释代码:

1
2
let x = 5;      // Declare x, give it the value of 5  
let y = x + 2;  // Declare y, give it the value of x + 2


多行注释

多行注释以 开头/*和结尾 */

/*和之间的任何文本都*/将被 JavaScript 忽略。

本例使用多行注释(注释块)来解释代码:

1
2
3
4
5
6
7
8
/*  
The code below will change
the heading with id = "myH"
and the paragraph with id = "myP"
in my web page:
*/
document.getElementById("myH").innerHTML = "My First Page";
document.getElementById("myP").innerHTML = "My first paragraph.";

最常见的是使用单行注释。
块注释通常用于正式文档。


使用注释来阻止执行

使用注释来阻止代码执行适合代码测试。

//在代码行前面添加会将代码行从可执行行更改为注释。

此示例使用 // 来阻止执行以下代码行之一:

1
2
//document.getElementById("myH").innerHTML = "My First Page";  
document.getElementById("myP").innerHTML = "My first paragraph.";

此示例使用注释块来防止执行多行:

1
2
3
4
/*  
document.getElementById("myH").innerHTML = "My First Page";
document.getElementById("myP").innerHTML = "My first paragraph.";
*/