這篇有點難以分類阿,最後把它放到了 Coding Style 的分類,但總覺得不太對 @@
這篇主要記錄一下,我在寫 code 時常用的註解標籤,這個習慣是以前用 Eclipse 時留下的 - TODO、FixMe、XXX,不過最近才發現似乎不同語言,對於這些標籤也有不同的解釋?
就我自己的解釋
-
TODO:
表示待實現的功能。 -
FixMe:
有問題或者不能運作的程式碼,需要修正。 -
XXX:
雖然功能已經實作,但實作方法有待商榷,希望能進行改進。
不過我在其他的地方看到其他幾個不同的標籤與解釋:
-
TODO 與 FixMe:
這兩個我比較沒有疑惑,就是代辦事項與 bug fix 的意思。 -
XXX:
這個標籤就跟我所知道完全不一樣了,它在這個體系下是類似於 HotFix 的標籤,優先序高於 FixMe。 -
HACK:
有點不是很理解文件中的解釋 - 表明代碼實現走了一個捷徑 @@??? 就我從維基百科的理解,HACK 指的是一種問題的解法,但這方法可能有點醜甚至有點莫名其妙,但卻是有用的時候,所以在我認知中這個標籤是對應到我的 XXX。 -
Review:
這個標籤則是說明任何改動都需要經過評審。
所以在使用註解標籤時,可能需要與你的協同者確定相關的註解機制,或者 follow 該語言的註解規則?