JavaScript是一種廣泛應用于網頁開發的腳本語言，它可以方便地操作文檔對象模型（DOM）、瀏覽器對象模型（BOM）等內容。為了使代碼更容易理解、維護，我們需要在代碼中添加注釋，以便于開發者或其他開發人員在更改或閱讀代碼時快速理解代碼意圖。本文將詳細介紹JavaScript文檔注釋的寫法和應用。

JavaScript文檔注釋可以分為單行注釋和多行注釋兩種。單行注釋使用“//”進行注釋，多行注釋使用“/* */”進行注釋，其中“/*”表示多行注釋開始，“*/”表示多行注釋結束，注釋內容放在“/*”和“*/”之間。例如：

//這是單行注釋
/*
這是
多行
注釋
*/

JavaScript文檔注釋可以用來注釋變量、函數、類等內容，注釋內容應該簡潔明了，不出現無關的描述。下面是一些注釋的示例：

//定義一個變量用來存儲用戶的名字
var userName;
/*
定義一個函數，用來查找數組中最小的數值，并返回這個數值
@param {Array} arr 要查找的數組
@return {number} 返回數組中最小的數值
*/
function findMin(arr) {
var min = arr[0];
for (var i = 1; i< arr.length; i++) {
if (arr[i]< min) {
min = arr[i];
}
}
return min;
}
/*
定義一個學生類，包含學生的姓名和年齡
@class
*/
class Student {
constructor(name, age) {
this.name = name;
this.age = age;
}
}

在注釋中還可以加上@param、@return、@class等標簽來更加清晰地說明函數、類的參數、返回值等內容。例如上面的findMin函數，采用了@param和@return標簽。

在注釋中還可以使用例子來說明函數或類的使用方法，例如：

/**
 * 定義一個計算兩個數字和的函數
 * @example
 * add(1, 2); // 3
 * add(0, 0); // 0
 * add(-1, 1); // 0
 * @param {number} x 第一個數字
 * @param {number} y 第二個數字
 * @return {number} 返回兩個數字的和
 */
function add(x, y) {
return x + y;
}

通過例子，其他開發人員可以更加直觀地了解函數的使用方法，大大提高了代碼的可讀性。

總的來說，JavaScript文檔注釋是一種非常重要的技能，能夠提高代碼的可讀性和可維護性，避免不必要的錯誤。在實際開發中，我們應該養成良好的習慣，及時添加注釋，保證代碼的可讀性和可維護性。