程式碼神註釋,讓我們認真對待一次!

Marno發表於2017-03-07

兄弟,請你冷靜的聽我扯淡,別動手!有本事點個關注再走,【對,就點這兒】

做一個有趣的程式設計師,歡迎關注我的公眾號【aMarno】,主要分享 React Native 技術


文末會附上幾個可以直接複製使用的註釋模板,更多請點末尾提到的連結。

前兩天我在朋友圈看到有個人在說:“好的程式碼是可以自己解釋自己的,所以我從來不寫註釋”。

程式碼神註釋,讓我們認真對待一次!

小夥子,你這麼裝 B,你家裡人知道嗎?不怕扯著蛋麼?

程式碼神註釋,讓我們認真對待一次!

不過對於這樣裝 B 的年輕人,老馬我只想喂他吃 10 萬行 the fucking source code。讓他好好體會一下沒有註釋看別人程式碼時那種酸爽的感覺!

程式碼神註釋,讓我們認真對待一次!

嗯,都說見不得別人裝 B 的人,其實只是見不得別人裝的比自己裝的厲害!咳咳....怎麼能這麼說呢?不過....到是....蠻有道理的,hou~

程式碼神註釋,讓我們認真對待一次!

不過單從裝 B 的角度來講,我想說:“小夥子,你還是 too young to simple 了,這樣難免顯得有些稚嫩了。”

程式碼神註釋,讓我們認真對待一次!

以我老馬混跡江湖多年的經驗來看,程式碼不僅要有註釋。而且像我們這種追求程式碼質(zhuang)量(B)的人,還必須要配上高(gou)質(zhuang)量(B)的註釋,那樣才符合我們的身份呀!

程式碼神註釋,讓我們認真對待一次!

言歸正傳,究竟怎麼編寫註釋才能體現身份呢?先給大家推薦一個網站,點選【這裡】可以跳轉(這網站一定是個有情懷的程式猿才能開發出來的)。

程式碼神註釋,讓我們認真對待一次!

有了這個網站
我的註釋變成了這樣的風格
我佛鎮樓!保程式碼永無 Bug

程式碼神註釋,讓我們認真對待一次!

在程式碼裡向妹子表個白?
你們部門裡沒有妹子怎麼辦?
男的總有吧!?
額...你要搞基也用得著!

程式碼神註釋,讓我們認真對待一次!

我是一匹來自北方的狼
你們誰懂我心理的傷

程式碼神註釋,讓我們認真對待一次!

程式碼、程式碼!
你可以禁錮我的身
但禁錮不了我向往藍天的心

程式碼神註釋,讓我們認真對待一次!

我害羞,看不見
這兩個人是要做啥?

程式碼神註釋,讓我們認真對待一次!

啊.....你寫的程式碼....
有毒!!

程式碼神註釋,讓我們認真對待一次!

跟我一起唱!
啊~啊~啊~
五環~你比四環多一環

程式碼神註釋,讓我們認真對待一次!

又或者你想講個故事

程式碼神註釋,讓我們認真對待一次!

程式碼神註釋,讓我們認真對待一次!

程式碼神註釋,讓我們認真對待一次!

程式碼神註釋,讓我們認真對待一次!

程式碼神註釋,讓我們認真對待一次!

程式碼神註釋,讓我們認真對待一次!

程式碼神註釋,讓我們認真對待一次!

程式碼神註釋,讓我們認真對待一次!

程式碼神註釋,讓我們認真對待一次!


嗯,這是一個悲傷的故事
我相信看了這樣的註釋
你一定會說
“計劃生育不讓生這麼多!”
我這麼努力煽情,你TM在逗我?

程式碼神註釋,讓我們認真對待一次!

看來是時候來一波福利了
(懶得複製到IDE裡了)

程式碼神註釋,讓我們認真對待一次!

程式碼神註釋,讓我們認真對待一次!

程式碼神註釋,讓我們認真對待一次!

其實這些都是小伎倆,估計老司機們都玩膩了。可能你之前只是看過,但不知道這些都是怎麼來的。那現在你也可以隨便找幾個來裝 B 一下了。如果以後和你協作的人,還有給你說註釋不重要的,那你直接在程式碼裡給他註釋一坨 xiang。冒熱氣的那種!

對了!有一點需要注意的是,這個網站上的註釋並不是直接複製過來就可以用的,否則排版會亂掉的。必須先複製到記事本中,並在每行前新增一個 * 號,然後在複製貼上到 塊註釋 中就可以了。

像我上面說的,裝 B 的人見不得別人裝的比自己厲害,所以肯定會有人說:“你這麼註釋一點也不實用!”拜託,我說實用了麼?我從一開始說的就是裝 B 啊。裝 B 的東西有實用的麼?!

程式碼不易,且敲且裝 B
—— By 老馬

程式碼神註釋,讓我們認真對待一次!

最後附上幾個可以直接複製使用的註釋模板。檢視更多請點這裡:【點我看更多】

/**
 *                 _._  ,mm_            =._
 *            ,m############m.      .-===-==--.._
 *          ,m#8888##88###88##m    --=.=--========-
 *         m#888#####888###888#m  /--'==----==-====`.
 *        ##88######8888####88#m |--'==------=--====`
 *        ###888###88888####88## |=|=====----==--====|
 *        ###########88## ###### `=|==.========---===|
 *        ##############" #####"  \=\=|\=/,=====--===|
 *        "######"~ ~=_'_,~ m#"    `.|>|/,=//===-===/
 *         "##( Y \_ "~'__/~'      .-||, ~'/,,=-====|
 *          (m#m_#m ~~' , `        | |    '~/======|'
 * marno    m# "#>#m    - 'm.       \|     _~'====|/
 *         ###  , "#m __.'"#m`.      |    / \====,'
 *         ###m_' `##m     "#m `    ,'  -|   `"=\
 *         "#'  `. `##`     "#m    '   ' |   |  =\
 *          '     `-##`     #"   ,'   '  |--.`   =|
 *         |         ~~-_      ,'    '  /~    .  =|
 *         |             ~-. _-     '  /      `. |=\
 *         |   ~~-.         ~      ' .'        ` \=/
 *         `       ~-.           ,'.~  '    '   |
 *          .     |   ~~-..__  _,',   .    .    |
 *          `      `.__.' _/ ~~  |    '    '    '
 *           .           .'       \  .    :    /
 *           `
 */複製程式碼
/**
 *                                     _
 *                                    (  )
 *     _ .                         ( `  ) . )
 *   (  _ )_                      (_, _(  ,_)_)
 * (_  _(_ ,)
 *                                                       |
 *         _  _                                        \ _ /
 *        ( `   )_                                   -= (_) =-
 *       (    )    `)                                  /   \
 *     (_   (_ .  _) _)                                  |
 *
 *                                _
 *                              -=\`\
 *                          |\ ____\_\__
 *                        -=\c`""""""" "`)
 *                           `~~~~~/ /~~`
 *                             -==/ /
 *                               '-'                 _
 *                                                  (  )
 *                _, _ .                         ( `  ) . )
 *               ( (  _ )_                      (_, _(  ,_)_)
 *      marno  (_(_  _(_ ,)
 */複製程式碼

/**
 *
 *          ,g  8b ,g                 ,g        8g   8g
 *      o8888"  88 Y8     .od888888888P"       88'  88'
 *        88    88 "        88  88  88        88'  88888888b
 *    8888888888888888   d88888888888888b    888  88  oo  88
 *        88    88       88    88      88   8'88 8'   88  P'
 *        88,o  88 o9,     888888888888       88    8 88
 *        88P   88,8P         88              88   o8 88 g
 *      ,888    888'         88888888b        88   8' 88 `8,
 *     d8'88   g88          88 gg ,88'        88  ,P  88  8b
 *     8' 88 oP 88,        d8' `g88'          88  8   88  `P
 *        88    `88 g     o8'  gg88b,         88 f    88
 *       d8'      `b'    o8  oP'   "Y8ao      88     d8'       I love you
 */複製程式碼

/**
 *                 uuuuuuu
 *             uu$$$uu
 *          uu$$$$$uu
 *         u$$$$$$u
 *        u$$$$$$u
 *       u$$$$$$$u
 *       u$$$$$$$u
 *       u$$"   "$"   "$$u
 *       "$"      u$u       $"
 *        $u       u$u       u$
 *        $u      u$u      u$
 *         "$uu$   $uu$"
 *          "$$"   "$$"
 *            u$$u$$u
 *             u$"$"$"$"$"$"$u
 *  uuu        $u$ $ $ $ $u$       uuu
 * u$        $$u$u$u$       u$
 *  $$uu      "$$$"     uu$$
 *u$$$uu    """""    uuuu$$$
 *$"""$$$uuu   uu$$$"""$"
 * """      ""$$MARNOuu ""$"""
 *           uuuu ""$$$uuu
 *  u$uuu$$$uu ""$$$uuu$
 *  $$$""""           ""$$$"
 *   "$$"                      ""$""
 *     $"                         $"
 */複製程式碼
/**
 *
 *     _.-"""""-._         _.-"""""-._         _.-"""""-._
 *   ,'           `.     ,'           `.     ,'           `.
 *  /               \   /               \   /               \
 * |                 | |                 | |                 |
 *|                   |                   |                   |
 *|                   |                   |                   |
 * |             _.-"|"|"-._         _.-"|"|"-._             |
 *  \          ,'   /   \   `.     ,'   /   \   `.          /
 *   `.       /   ,'     `.   \   /   ,'     `.   \       ,'
 *     `-..__|..-'         `-..|_|..-'         `-..|__..-'
 *          |                   |                   |
 *          |                   |                   |
 *           |                 | |                 |
 *            \               /   \               /
 *             `.           ,'     `.           ,'
 *               `-..___..-'         `-..___..-'
 *
 */複製程式碼

相關文章