iT邦幫忙

2022 iThome 鐵人賽

DAY 30
0
自我挑戰組

轉職軟體工程師技術手冊系列 第 30

Day30【轉職軟體工程師技術手冊】你應該知道的註解「TODO Comments」

  • 分享至 

  • xImage
  •  
//
//                       _oo0oo_
//                      o8888888o
//                      88" . "88
//                      (| -_- |)
//                      0\  =  /0
//                    ___/`---'\___
//                  .' \\|     |// '.
//                 / \\|||  :  |||// \
//                / _||||| -:- |||||- \
//               |   | \\\  -  /// |   |
//               | \_|  ''\---/''  |_/ |
//               \  .-\__  '-'  ___/-. /
//             ___'. .'  /--.--\  `. .'___
//          ."" '<  `.___\_<|>_/___.' >' "".
//         | | :  `- \`.;`\ _ /`;.`/ - ` : | |
//         \  \ `_.   \_ __\ /__ _/   .-` /  /
//     =====`-.____`.___ \_____/___.-`___.-'=====
//                       `=---='
//
//
//     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
//
//               佛祖保佑         永无BUG
//

不知道為何,學寫程式的過程總是很少人會告訴你註解該怎麼寫。

TODO Comments介紹

註解除了很常見的告訴別人這段程式的意義以外,寫程式總會遇到一些必須做但現在沒辦法做的事,這時候我們可以選擇留下標註。

以下引用IntelliJ IDEA對TODO comments的描述:

Sometimes, you need to mark parts of your code for future reference: areas of optimization and improvement, possible changes, questions to be discussed, and so on. IntelliJ IDEA lets you add special types of comments that are highlighted in the editor, indexed, and listed in the TODO tool window. This way you and your teammates can keep track of issues that require attention.

白話的意思是,我們可以在程式中留下要改善要更動要討論的東西的標記,TODO Comments就是一個這樣的標記,並且藉由工具迅速的列出TODO清單,快速的定位任何留在程式中的TODO。

常用的TODO Comments有

  • TODO
  • FIXME

注意的事項

  • TODO Comments皆大寫
  • 簡述TODO的內容或原因,不要僅寫// TODO
  • 在結尾的部分寫上by who未來比較好回憶
    • 因為DO的人不見得自己,這時候有人能提供當初寫下TODO的故事就會很有幫助。
  • 一般認為FIXME會用在有bug需要修復的情況下

示範例子

以下介紹在VS Code跟Eclipse如何使用TODO Comments

VS Code

在上一篇Visual Studio Code前端常見擴展工具有推薦過Todo Tree給大家,
安裝完成後可以複製貼上以下的程式到你的開發者工具中試試。

偽代碼

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta http-equiv="X-UA-Compatible" content="IE=edge">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>Document</title>
</head>
<body>
  <!-- TODO 應該改用main來代替div,但要確認rwd畫面不會跑版 by vic -->
  <div></div>
  <script>
    // TODO 這個function用遞迴在xx情況下會導致效能下降太快,待優化 by vic
    const a = () => {}
  </script>
</body>
</html>

實際畫面

Eclipse

偽代碼

public class TestTodoComments {

	public static void main(String[] args) {
		// TODO syso不用呼叫兩次 by Vic
		System.out.print("Hello ");
		System.out.print("World");
	}

}

叫出窗格

開啟的檔案中有TODO Comments會在卷軸旁邊出現藍色方框

JetBrains全家桶

參考官網

延伸閱讀


註解來源: https://gist.github.com/edokeh/7580064


上一篇
Day29【轉職軟體工程師技術手冊】Visual Studio Code介紹
下一篇
Day31【轉職軟體工程師技術手冊】考證照對求職有幫助嗎?
系列文
轉職軟體工程師技術手冊34
圖片
  直播研討會
圖片
{{ item.channelVendor }} {{ item.webinarstarted }} |
{{ formatDate(item.duration) }}
直播中

尚未有邦友留言

立即登入留言