跳到主要内容

JavaScript 注释

提示
  1. 注释的目的:JavaScript中的注释用于帮助程序员理解代码,它们在代码执行时被JavaScript引擎忽略。
  2. 单行和多行注释:使用//添加单行注释,而/* */用于编写多行注释。
  3. 注释在调试和说明中的应用:注释可以用来禁用代码以便调试,或者为了让代码更易于理解,尤其是在解释代码的目的时。

JavaScript 注释是程序员可以添加的提示,使代码更易于阅读和理解。这些注释会被 JavaScript 引擎完全忽略。

有两种方式可以在代码中添加注释:

  • // - 单行注释
  • /* */ - 多行注释

单行注释

在 JavaScript 中,任何以 // 开头的行都是单行注释。例如,

name = "Jack";

// 在控制台打印名字
console.log("Hello " + name);

这里,// 在控制台打印名字 是一个注释。

您也可以这样使用单行注释:

name = "Jack";

console.log("Hello " + name); // 在控制台打印名字

多行注释

在 JavaScript 中,任何在 /**/ 之间的文本都是多行注释。例如,

/* 下面的程序包含了一个名为 Baghchal 的游戏的源代码。

Baghchal 是尼泊尔流行的棋盘游戏,两位玩家可以选择扮演羊或老虎。它在一个 5x5 的网格上进行。

控制老虎的玩家要赢得比赛,必须捕获所有的羊。棋盘上总共有 4 只老虎。

羊要赢,所有的老虎必须被包围和困住,使它们不能移动。控制羊的玩家有 20 只羊可以使用。
*/

由于其余的源代码将用于实现游戏规则,上面的注释是使用多行注释的一个很好的例子。

使用注释进行调试

注释还可以用来禁用代码,防止其执行。例如,

console.log("一些代码");
console.log("错误代码);
console.log("其他代码");

如果在运行程序时遇到错误,您可以使用注释来禁用可能引起错误的代码,而不是删除它;这可以是一个宝贵的调试工具。

console.log("一些代码");
// console.log("错误代码);
console.log("其他代码");

专业提示: 记住使用注释的快捷方式,这可能非常有用。对于大多数代码编辑器,Windows 是 Ctrl + /,Mac 是 Cmd + /

使代码更易于理解

作为一名 JavaScript 开发人员,您不仅要编写代码,还可能需要修改其他开发人员编写的代码。

如果您在代码中编写注释,将来理解代码会更容易。同时,您的同事也会更容易理解代码。

一般来说,使用注释来解释您为什么这样做,而不是怎么做的,您就做得很好。

注意: 注释不应该用作解释用英语写成的糟糕代码的替代品。您应该始终编写结构良好、自解释的代码。然后再使用注释。