<p>js注解包括单行注释（//）、多行注释（/ /）和文档注释（/* /），用于提升代码可读性与维护性，其中文档注释支持JSDoc标签如@param、@returns，便于生成文档和ide提示，合理使用可增强协作效率。</p>
JS注解（也称javaScript注释）是用来在代码中添加说明性文字，帮助开发者理解代码逻辑、功能或注意事项。注释不会被浏览器执行，对程序运行无影响，但对代码可读性和维护性至关重要。以下是JS注解的标准书写格式与语法说明。
单行注释
使用双斜杠 // 开始，该行从双斜杠到行尾的所有内容都会被解释器忽略。
• 适合简短说明，如变量用途、函数作用等• 常用于调试时临时屏蔽代码
示例：
// 定义用户姓名let userName = “Alice”;// console.log(“调试信息”);
多行注释
使用 /* 开始，*/ 结束，中间的内容无论多少行都会被注释掉。
• 适合较长的说明，如函数功能描述、版权信息等• 可用于批量注释代码块
示例：
/* 这是一个计算总价的函数 参数：price – 单价，count – 数量 返回：总价*/function getTotal(price, count) { return price * count;}
文档注释（JSDoc）
一种特殊的多行注释，以 /** 开头，配合特定标签为代码生成文档，常用于函数、类、模块的说明。
• 被IDE和工具（如JSDoc、typescript）识别，提供智能提示• 提高团队协作效率
常用标签：
@param {类型} 参数名 – 参数说明@returns {类型} – 返回值说明@description – 功能描述
示例：
/** * 计算矩形面积 * @param {number} width – 矩形宽度 * @param {number} height – 矩形高度 * @returns {number} 返回面积值 */function getArea(width, height) { return width * height;}
基本上就这些。合理使用注释能让代码更清晰，但也要避免过度注释或写无意义的内容。保持注释与代码同步更新，才能真正发挥作用。不复杂但容易忽略。