聊聊javascript的几种注释字符

JavaScript是一种广泛使用的编程语言。其中注释是一种非常重要的功能，可以帮助开发人员增强代码的可读性、可维护性和可重用性。注释是一种特殊的语句，不会被执行，但是它可以告诉其他人关于代码的一些补充信息。JavaScript中有多种注释字符可供使用，本文将会介绍这些注释及其适用场景。

1. 单行注释（//）

单行注释使用“//”字符，可以在代码行末尾注释一行代码。例如：

var num1 = 10;var num2 = 20; //这里是注释，说明这个变量用途

单行注释也可以在一行代码中注释多个语句。例如：

var a = 1; //变量avar b = 2; //变量bvar c = a + b; //计算a+bconsole.log(c); //输出c的值

单行注释适用于对代码进行短暂的注释，例如对变量的用途、函数的功能进行简单的说明。

2. 多行注释（/ /）

多行注释使用/ /将多行代码包裹起来，注释的部分不能对代码造成影响。例如：

/* 这里是多行注释可以在其中写入多行代码 */var num1 = 10;var num2 = 20;

多行注释适用于对一段较长代码进行注释说明，例如函数的实现、代码段的功能等。

3. 文档注释（/* /）

文档注释是一种特殊的多行注释。它们以"/*"开头，并以"/"结尾。文档注释可以包含函数、类或对象的说明信息，其中包括参数、返回值等信息。例如：

/** * 计算两个数之和 * @param {number} x 第一个数 * @param {number} y 第二个数 * @returns {number} 返回两个数之和 */function sum(x, y) {  return x + y;}

文档注释适用于编写API文档时，方便其他人阅读和使用代码。

除了上述三种注释之外，还有一些其他的注释方式：

4. '@license'注释

当您编写的JavaScript代码是开源的时，应该在文件开头添加一些注释，例如"@license"，以声明代码使用的许可证。例如：

/* * @license * My Project v1.0.0 * (c) 2022 My Name <me@example.com> * License: MIT */

5. '@param'注释

当您编写代码中的函数，并且函数具有参数时，您可以使用"@param"注释来解释每个参数的类型和作用。例如：

/** * 计算两个数之和 * @param {number} x 第一个数 * @param {number} y 第二个数 * @returns {number} 返回两个数之和 */function sum(x, y) {  return x + y;}

6. '@returns'注释

如果您编写的函数返回值，则可以使用"@returns"注释标识该函数的返回值类型。例如：

/** * 计算两个数之和 * @param {number} x 第一个数 * @param {number} y 第二个数 * @returns {number} 返回两个数之和 */function sum(x, y) {  return x + y;}

在编写注释时，注意保持注释与代码的一致性，掌握适用的注释方式可以大大提高代码的可读性和可维护性。同时应该在设计代码时尽量考虑到其他人的阅读和使用情况，编写规范的注释也是一种良好的编码习惯。

以上就是聊聊javascript的几种注释字符的详细内容，更多请关注Gxl网其它相关文章！