hbuilderx注释

### HBuilderX 中的注释语法及使用方法

#### 单行注释
单行注释用于快速标记代码中的某一行或几行文字解释。只需在要注释的内容前加上两个斜杠 `//`。

// 这是一个简单的单行注释示例
let message = "Hello, world!";
console.log(message); // 输出消息到控制台

#### 多行注释
多行注释适合于较长的文字说明，通过 `/ * 和 * /` 来包裹需要被忽略的部分。

/* 
这是一个跨越多行的注释，
可以用来提供更详细的描述。
*/
function addNumbers(a, b) {
    return a + b;
}

#### JSDoc 注释风格
为了增强开发体验并提高效率，HBuilderX 支持 jsdoc+ 扩展格式[^2]。这种特殊的文档化注解不仅能够帮助理解函数的作用及其参数含义，还能让 IDE 提供更加精准的帮助提示。

/**
 * 计算两个数相加的结果.
 *
 * @param {number} num1 - 第一个加数.
 * @param {number} num2 - 第二个加数.
 * @returns {number} 返回两数之和.
 */
function sum(num1, num2) {
    return num1 + num2;
}

const result = sum(3, 7);
console.log(result); // 结果应为 10