[C 的那些眉角]註解要寫「為什麼」,不是「做什麼」

記得很久以前,我寫註解的方式大概類似這樣:

i++;  // i 加 1

現在想起來,覺得很好笑。
當時覺得「有寫註解」這件事本身就是好習慣,
至於寫了什麼⋯⋯好像不太重要?

後來進公司,第一次被 senior 在 code review 上留言:
「這個註解跟沒寫一樣。」

很直接,但他說得對。

閱讀全文

[C 語言]註解大解密:/* */ vs // 該怎麼選?

在學習 C 語言的過程中,你是否曾經困惑過:為什麼有些程式碼用 // 註解,有些卻用 /* */?哪一種比較好?這個看似簡單的問題,其實藏著不少學問。今天,讓我們一起深入探討這兩種註解方式的優缺點,幫助你在不同情境下做出最佳選擇!


🔍 兩種註解方式的歷史背景

在開始比較之前,先了解一下歷史:/* */ 是 C 語言最早期(C89/C90 標準)就存在的註解方式,而 // 則是從 C++ 借鑑過來,直到 C99 標準才正式納入 C 語言。這個歷史差異也解釋了為什麼在某些舊系統或嵌入式開發中,/* */ 仍然佔據主導地位。

📊 詳細比較:優缺點分析

閱讀全文