兄弟,請你冷靜的聽我扯淡,別動手!有本事點個關注再走,【對,就點這兒】
做一個有趣的程式設計師,歡迎關注我的公眾號【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$
* $$$"""" ""$$$"
* "$$" ""$""
* $" $"
*/複製程式碼
/**
*
* _.-"""""-._ _.-"""""-._ _.-"""""-._
* ,' `. ,' `. ,' `.
* / \ / \ / \
* | | | | | |
*| | | |
*| | | |
* | _.-"|"|"-._ _.-"|"|"-._ |
* \ ,' / \ `. ,' / \ `. /
* `. / ,' `. \ / ,' `. \ ,'
* `-..__|..-' `-..|_|..-' `-..|__..-'
* | | |
* | | |
* | | | |
* \ / \ /
* `. ,' `. ,'
* `-..___..-' `-..___..-'
*
*/複製程式碼