JS注释符号

在JavaScript中，‌注释的符号主要有三种：‌

1. 单行注释：‌使用//符号。‌这种注释方式用于注释一行内容，‌从//开始到行尾都是注释内容。‌单行注释适用于对代码进行短暂的注释，‌例如对变量的用途、‌函数的功能进行简单的说明。‌

   javascriptCopy Code
   // 这是一个单行注释的例子
var x = 10;


2. 多行注释：‌使用/*和*/符号。‌这种注释方式用于注释多行内容，‌从/*开始到*/结束的部分都是注释内容。‌多行注释适用于对一段较长代码进行注释说明，‌例如函数的实现、‌代码段的功能等。‌

   javascriptCopy Code
   /*
这是一个多行注释的例子，‌
可以包含多行内容。‌
*/
var y = 20;


3. 文档注释：‌使用/**/符号，‌这是一种特殊的多行注释方式，‌通常用于编写API文档时，‌方便其他人阅读和使用代码。‌文档注释可以包含函数、‌类或对象的说明信息，‌包括参数、‌返回值等信息。‌

   javascriptCopy Code

   /**
* 这是一个文档注释的例子，‌用于说明函数的功能和参数。‌
* @param {number} a - 第一个参数
* @param {number} b - 第二个参数
* @returns {number} - 返回两个数之和
*/
function add(a, b) {
return a + b;
}


除了上述三种注释方式，‌还有一些其他的注释方式，‌例如@license注释，‌当编写的JavaScript代码是开源的时，‌应在文件开头添加一些注释声明代码使用的许可证。‌