注釋，今晚我不關心代碼，我只想你

2021 年 3 月 2 日
筆記

一

世上本沒有注釋，垃圾代碼寫多了，也便有了注釋。

注釋彷彿是依賴於代碼存在的。

你會要求代碼乾淨，整潔，優雅，雖然你自己都做不到這三點。

但是從來沒聽過你要求注釋要押韻，要是七言絕句，要形散而神不散。

編譯器，都會把注釋忽略掉。

甚至有人說好的代碼即是注釋，你看，其實連人都不需要注釋。

即便面試吹逼，你也不會說自己喜歡寫注釋。

怎麼了，是注釋不配嗎？

你明明忘了，剛開始學代碼時，你能看懂的只有注釋啊！

我職業生涯最大的挑戰，不是看不懂代碼，而且看不懂注釋。

尤其注釋只有六個字：「別動，後果自負」。

在單個函數超過一千行屎山代碼和一天開發兩天上線的傻X需求之前，能拯救我的只有注釋。

沒有注釋，我只能罵娘。

但我不會罵娘，因為我會要求自己乾淨，整齊，優雅。

所以，即便是注釋，我也要認真寫，用中英日德法語寫，重構着寫，甚至用設計模式寫。

而今天，和大家分享一些有趣的注釋。

二

也可參考 //github.com/Blankj/awesome-comment

/***
 *                    .::::.
 *                  .::::::::.
 *                 :::::::::::  FUCK YOU
 *             ..:::::::::::'
 *           '::::::::::::'
 *             .::::::::::
 *        '::::::::::::::..
 *             ..::::::::::::.
 *           ``::::::::::::::::
 *            ::::``:::::::::'        .:::.
 *           ::::'   ':::::'       .::::::::.
 *         .::::'      ::::     .:::::::'::::.
 *        .:::'       :::::  .:::::::::' ':::::.
 *       .::'        :::::.:::::::::'      ':::::.
 *      .::'         ::::::::::::::'         ``::::.
 *  ...:::           ::::::::::::'              ``::.
 * ```` ':.          ':::::::::'                  ::::..
 *                    '.:::::'                    ':'````..
 */

/***
 * //www.freebuf.com/
 *           _.._        ,------------.
 *        ,'      `.    ( We want you! )
 *       /  __) __` \    `-,----------'
 *      (  (`-`(-')  ) _.-'
 *      /)  \  = /  (
 *     /'    |--' .  \
 *    (  ,---|  `-.)__`
 *     )(  `-.,--'   _`-.
 *    '/,'          (  Uu",
 *     (_       ,    `/,-' )
 *     `.__,  : `-'/  /`--'
 *       |     `--'  |
 *       `   `-._   /
 *        \        (
 *        /\ .      \.  freebuf
 *       / |` \     ,-\
 *      /  \| .)   /   \
 *     ( ,'|\    ,'     :
 *     | \,`.`--"/      }
 *     `,'    \  |,'    /
 *    / "-._   `-/      |
 *    "-.   "-.,'|     ;
 *   /        _/["---'""]
 *  :        /  |"-     '
 *  '           |      /
 *              `      |
 */