JavaScript 中的注釋 注釋在編程中是一個非常重要的工具，在 JavaScript 中也不例外。一個好的注釋可以給代碼增加可讀性，同時也能幫助開發者更好地了解代碼的邏輯。本文將向大家介紹 JavaScript 中的注釋類型及其使用方法。 // 單行注釋 在 JavaScript 中，使用‘//’來表示單行注釋。在這之后的所有內容都將被視為注釋，不會被編譯器執行。這種注釋比較適合用于解釋某一行代碼的作用，或者是臨時注釋掉一行代碼。下面是一個使用單行注釋的例子：

function add(a, b) {
// 這是一個加法函數
return a + b;
}

/* 多行注釋 */ 如果需要注釋的內容比較多，或者需要注釋掉一整段代碼，那么使用‘/*’和‘*/’來表示多行注釋就比單行注釋更合適了。下面是一個使用多行注釋的例子：

/*
這個函數用于登錄系統。
@param {string} username 用戶名
@param {string} password 密碼
@return {boolean} 是否登錄成功
@throws {Error} 如果用戶名或密碼為空字符串
*/
function login(username, password) {
if (!username || !password) {
throw new Error('用戶名或密碼不能為空');
}
// 登錄邏輯...
return true;
}

這個例子中，通過多行注釋來寫出了函數的一些信息，包括函數的作用、參數類型、返回值類型以及可能發生的錯誤。這樣做可以大大增加代碼的可讀性。 /** 文檔注釋 */ 除了上述的注釋方式，還有一種專門用于文檔注釋的類型——‘/** */’。文檔注釋的內容可以被 JSDoc 工具讀取并生成文檔，這樣開發者就可以更方便地了解代碼的功能了。下面是一個使用文檔注釋的例子：

/**
 * 這個函數用于將數組中的每個元素平方。
 *
 * @param {Array} arr 需要處理的數組
 *
 * @returns {Array} 平方后的數組
 */
function square(arr) {
return arr.map(item =>item ** 2);
}

這個例子中，使用 JSDoc 的語法來描述函數的作用、參數類型以及返回值類型，并且添加了一些注釋，幫助開發者更好地理解代碼。 總結 在 JavaScript 中，注釋是一種非常重要的工具，能夠大大提高代碼的可讀性。我們在編寫代碼時需要養成良好的注釋習慣，以便于自己和他人更好地理解代碼。