在學習 C 語言的過程中，你是否曾經困惑過：為什麼有些程式碼用 // 註解，有些卻用 /* */？哪一種比較好？這個看似簡單的問題，其實藏著不少學問。今天，讓我們一起深入探討這兩種註解方式的優缺點，幫助你在不同情境下做出最佳選擇！
🔍 兩種註解方式的歷史背景
在開始比較之前，先了解一下歷史：/* */ 是 C 語言最早期（C89/C90 標準）就存在的註解方式，而 // 則是從 C++ 借鑑過來，直到 C99 標準才正式納入 C 語言。這個歷史差異也解釋了為什麼在某些舊系統或嵌入式開發中，/* */ 仍然佔據主導地位。
📊 詳細比較：優缺點分析
/* */ (區塊註解) 的特性：
優點：
– ✅ 最佳相容性：所有 C 編譯器都支援，無論多老舊
– ✅ 跨多行自由：適合撰寫長篇的函數說明或演算法解釋
– ✅ 行內註解：可以在程式碼中間插入註解，例如 x = a /* 中間註解 */ + b;
– ✅ 文件化標準：許多文件生成工具（如 Doxygen）偏好這種格式
缺點：
– ❌ 無法巢狀使用：這是最大的痛點！當你想註解掉一段已經包含 /* */ 的程式碼時，會導致編譯錯誤
– ❌ 容易出錯：忘記關閉 */ 可能導致大段程式碼意外被註解
– ❌ 除錯不便：快速註解/取消註解時不如 // 方便
/* 外層註解開始
int x = 10;
/* 這裡想再註解 */ // ❌ 編譯器會在這裡結束註解
int y = 20; // 這行不會被註解！
*/
// (單行註解) 的特性：
優點：
– ✅ 簡潔直觀：一眼就能看出註解範圍
– ✅ 可以巢狀：註解包含 // 的程式碼完全沒問題
– ✅ 除錯友善：快速註解/取消註解非常方便
– ✅ 更安全：不會因為忘記關閉而影響後續程式碼
– ✅ 現代標準：C99 之後的正式標準，所有現代編譯器都支援
缺點：
– ❌ 多行需重複：每一行都要加 //，稍微繁瑣
– ❌ 相容性問題：極少數古老編譯器可能不支援（現在幾乎不存在）
// 這是單行註解
// 多行註解需要
// 每行都加 //
// 但可以安全巢狀
// int old_code() {
// // 這裡有舊註解 ✅ 完全沒問題
// return 0;
// }
🎯 實務應用建議
根據多年的開發經驗，我建議採用「混合策略」：
| 使用場景 | 推薦方式 | 理由 |
|---|---|---|
| 單行說明 | // |
簡潔明瞭 |
| 函數文件註解 | /* */ |
符合文件化標準 |
| 檔案頭說明 | /* */ |
傳統慣例，美觀 |
| 快速除錯 | // |
方便快速開關 |
| 行尾註解 | // |
更清晰易讀 |
| 多行演算法說明 | /* */ |
視覺上更整齊 |
💡 實戰範例
/**
* ✅ 推薦：函數文件用 /* */
* 計算陣列平均值
* @param arr 整數陣列
* @param size 陣列大小
* @return 平均值（浮點數）
*/
double calculate_average(int arr[], int size) {
// ✅ 推薦：單行說明用 //
int sum = 0; // 累加總和
for (int i = 0; i < size; i++) {
sum += arr[i];
}
// ✅ 推薦：除錯時用 //
// printf("Debug: sum = %d\n", sum);
return (double)sum / size;
}
// ❌ 避免：用 /* */ 註解包含 /* */ 的程式碼
/*
void old_function() {
int x = 10; /* 舊註解 */ // 這會導致錯誤！
}
*/
// ✅ 正確：用 // 註解包含任何內容都安全
// void old_function() {
// int x = 10; /* 舊註解 */ // 完全沒問題
// }
🏢 不同專案的慣例
Linux Kernel 風格：
偏好 /* */，並有嚴格的多行註解格式：
/*
* 這是 Linux Kernel 風格的
* 多行註解格式
*/
現代開源專案：
多數混用，以 // 為主要註解方式，/* */ 用於文件化。
嵌入式系統：
為了最大相容性，通常優先使用 /* */。
⚠️ 常見陷阱
- 巢狀註解陷阱：
/* 註解開始
/* 想再註解這裡 */ // ❌ 外層註解在這裡結束
這行不會被註解！
*/
- 忘記關閉註解：
/* 開始註解
int function1() { return 1; }
int function2() { return 2; }
// 忘記寫 */，下面的程式碼都被註解了！
- 字串中的註解符號：
char *str = "http://example.com"; // ✅ 沒問題
char *comment = "/* 這不是註解 */"; // ✅ 也沒問題
結尾：
選擇 /* */ 還是 // 並沒有絕對的對錯，重要的是：
1. 了解各自的優缺點
2. 根據使用場景選擇
3. 保持團隊風格一致
在現代 C 開發中，我個人建議以 // 作為日常註解的主力，配合 /* */ 處理文件化需求。這樣既能享受 // 的便利性，又能保持專業的文件風格。
你的專案中偏好哪種註解方式呢？有沒有遇過因為註解方式而踩到的坑？歡迎在下方留言分享你的經驗，讓我們一起交流學習！
希望這篇文章能幫助您和讀者更深入理解 C 語言註解的選擇策略！如果需要調整語氣、增加範例或修改任何部分，歡迎隨時告訴我 😊