碼注釋,有些人說它太丑,也有些人說它是標準和良好的做法。在本文中, 列出了一些在編程中遇到的有趣的代碼注釋。
// Weed Effect !
這是雜草效應的意思?不是很懂,有誰知道,可以留言一下。
/**** 原文 *****/
//The following code was written by <developer name>.
// Unless it doesn't work, then I have no idea who wrote it.
/**** 自譯 *****/
// 以下代碼是由<developer name>編寫的。
// 除非它不起作用,否則我不知道是誰寫的。
/**** 原文 *****/
// Ad Index scheming and plotting - Those with
// heart conditions are advised to not continue
/**** 自譯 *****/
// 廣告索引的設計和繪圖模塊
// 建議不要深入閱讀,否則容得得心臟病
/**** 原文 *****/
// nobody read comments!
/**** 自譯 *****/
// 沒人會讀的注釋
/**** 原文 *****/
i++; // increment i
/**** 自譯 *****/
i++; // 自增 i
/**** 原文 *****/
// Magic. Do not touch.
/**** 自譯 *****/
// 這里已經結界,不要碰.
/**** 原文 *****/
// sometimes I believe compiler ignores all my comments
/**** 自譯 *****/
// 有時我相信編譯器會忽略我的所有注釋
/**** 原文 *****/
// I am not responsible of this code.
// They made me write it, against my will.
/**** 自譯 *****/
// 我對此代碼不承擔任何責任。
// 是他們強迫我讓我寫的,這已違背了我的意愿。
/**** 原文 *****/
//
// Dear maintainer:
//
// Once you are done trying to 'optimize' this routine,
// and have realized what a terrible mistake that was,
// please increment the following counter as a warning
// to the next guy:
//
// total_hours_wasted_here = 42
/**** 自譯 *****/
// 親愛的程序媛
//
// 一旦你嘗試“優化”此代碼,并意識到這是一個可怕的錯誤,
// 請增加以下計數器,以警告下一個人
// total_hours_wasted_here = 42
/**** 原文 *****/
# To understand recursion, see the bottom of this file
At the bottom of the file
# To understand recursion, see the top of this file
/**** 自譯 *****/
# 要了解遞歸,請參見此文件的底部
在文件的底部
# 要了解遞歸,請參見此文件的頂部
/**** 原文 *****/
// I will give you two of my seventy-two virgins if you can fix this.
/**** 自譯 *****/
// 如果你能解決這個問題,我就把我七十二個處女中的兩個給你。
/**** 原文 *****/
//Dear future me. Please forgive me.
//I can't even begin to express how sorry I am.
/**** 自譯 *****/
// 你好,未來帥氣的我,請原諒我。
// 我現在無法表達我的歉意,因為我寫下了這段代碼。
/**** 原文 *****/
//private instance variable for storing age
public static int age;
/**** 自譯 *****/
// 用于存儲年齡的私有實例變量
public static int age;
/**** 原文 *****/
const int TEN=10; // s if the value of 10 will fluctuate...
/**** 自譯 *****/
const int TEN=10; // 10 是會改變的值
/**** 原文 *****/
/* You are not meant to understand this */
/**** 自譯 *****/
/* 你不應該理解這一點 */
/**** 原文 *****/
/*
* TODO: Remove this function
function remove($customer_id)
{
$this->Customer->remove($id);
}
*/
/**** 自譯 *****/
/*
* TODO: 刪除函數
function remove($customer_id)
{
$this->Customer->remove($id);
}
*/
/**** 原文 *****/
//When I wrote this, only God and I understood what I was doing
//Now, God only knows
/**** 自譯 *****/
// 當我寫這段代碼,只有上帝和我知道這是在做什么
...
// 現在,只有上帝知道這段代碼在做什么
/**** 原文 *****/
// drunk, fix later
/**** 自譯 *****/
// 喝醉了,待會解決
/**** 原文 *****/
// I'm sorry.
/**** 自譯 *****/
// 我很抱歉
/**** 原文 *****/
// I am not responsible of this code.
/**** 自譯 *****/
// 我對此代碼不承擔任何責任。
/**** 原文 *****/
// I have to find a better job
/**** 自譯 *****/
// 我必須找到更好的工作
/**** 原文 *****/
// Joe is sorry
A few hundred lines later...
// Harry is sorry too
/**** 自譯 *****/
// 老五抱歉了
寫了幾百行代碼之后...
// 小五對不住了
/**** 原文 *****/
# Christmas tree initializer
toConnect = []
toRead = [ ]
toWrite = [ ]
primes = [ ]
responses = {}
remaining = {}
/**** 自譯 *****/
# 圣誕樹初始化器
toConnect = []
toRead = [ ]
toWrite = [ ]
primes = [ ]
responses = {}
remaining = {}
/**** 原文 *****/
Catch (Exception e) {
// who cares?
}
/**** 自譯 *****/
Catch (Exception e) {
// 管它呢?
}
/**** 原文 *****/
// IE7 update. this is still bad code, but IE8 is probably a long way off :)
/**** 自譯 *****/
IE7更新,這仍然是錯誤的代碼,看來 IE8 還有很長的路要走:)
/**** 原文 *****/
// If this code works, it was written by Paul DiLascia. If not, I don't know
/**** 自譯 *****/
// 如果這個代碼有效的話,它就是由 前端小智 編寫的。如果出錯了,我也不知道是誰寫的。
/**** 原文 *****/
// This comment is self explanatory.
/**** 自譯 *****/
// 這個注釋不言自明。
/**** 原文 *****/
int main(void)
/* Program starts here */
/**** 自譯 *****/
int main(void)
/* 程序從這里開始 */
/**** 原文 *****/
// I am not sure if we need this, but too scared to delete.
/**** 自譯 *****/
// 我不確定我們是否需要這個,但又害怕刪除
/**** 原文 *****/
/**
* Always returns true.
*/
public boolean isAvailable() {
return false;
}
/**** 自譯 *****/
/**
* 總是返回 true.
*/
public boolean isAvailable() {
return false;
}
/**** 原文 *****/
// Autogenerated, do not edit. All changes will be undone.
/**** 自譯 *****/
// 自動生成,不要編輯。所有的更改都將被撤銷。
/**** 原文 *****/
// hack for ie browser (assuming that ie is a browser)
/**** 自譯 *****/
// 破解ie瀏覽器(假設ie是一個瀏覽器)
/**** 原文 *****/
/////////////////////////////////////// this is a well commented line
/**** 自譯 *****/
/////////////////////////////////////// 這是一個很好的注釋
/**** 原文 *****/
// Mr. Compiler, please do not read this.
/**** 自譯 *****/
// 編譯先生,請不要讀取這個
/**** 原文 *****/
// All bugs added by David S. Miller
/**** 自譯 *****/
// 所有 bug 都是由 老王 添加的
/**** 原文 *****/
//If you're reading this, then my program is probably a success
/**** 自譯 *****/
// 如果你現在在認真詳細的閱讀這段代碼,那么寫的這段代碼應該是沒有問題的。
/**** 原文 *****/
Catch (Exception e) {
//eat it
}
/**** 自譯 *****/
Catch (Exception e) {
// 吃掉它
}
/**** 原文 *****/
//todo: never to be implemented
/**** 自譯 *****/
// todo:永遠不會執行
/**** 原文 *****/
// simply copied from another code
/**** 自譯 *****/
// 別問,問我也是從另一個代碼拷貝過來的
/**** 原文 *****/
//Please comment on your source code
/**** 自譯 *****/
// 拜托啦,請把你寫的代碼注釋一下
/**** 原文 *****/
# as you can see: I comment the code!
/**** 自譯 *****/
# 如你所見:我注釋了代碼!
/**** 原文 *****/
// if i ever see this again i'm going to start bringing guns to work
/**** 自譯 *****/
// 如果我再看到這個,我會帶槍去工作
def format_ticket_content(text, recursive = true)
if text.is_a?(TicketNote)
note = text
text = note.content
else
note = nil
end
## Safety pig has arrived!
text = h(text)
## _
## _._ _..._ .-', _.._(`))
## '-. ` ' /-._.-' ',/
## ) \ '.
## / _ _ | \
## | a a / |
## \ .-. ;
## '-('' ).-' ,' ;
## '-; | .'
## \ \ /
## | 7 .__ _.-\ \
## | | | ``/ /` /
## /,_| | /,_/ /
## /,_/ '`-'
##
/**** 原文 *****/
long long ago; /* in a galaxy far far away */
/**** 自譯 *****/
long long ago; /* 在遙遠的星系中 */
/**** 原文 *****/
try {
} finally { // should never happen
}
/**** 自譯 *****/
try {
} finally { // 這里永遠不會被執行
}
/**** 原文 *****/
/* Ah ah ah! You'll never understand why this one works. */
/**** 自譯 *****/
// 啊啊啊!你永遠都不會明白為什么這個方法有效。
/**** 原文 *****/
// this formula is right, work out the math yourself if you don't believe me
/**** 自譯 *****/
// 這個公式是正確的,如果你不相信我,自己動手算一下
/**** 原文 *****/
// This was clearly written under duress
/**** 自譯 *****/
// 這顯然是在脅迫下寫的
.=' ' .`/,/!(=)Zm.
.._,,._.. ,-`- `,\ ` -` -`\\7//WW.
,v=~/.-,-\- -!|V-s.)iT-|s|\-.' `///mK%.
v!`i!-.e]-g`bT/i(/[=.Z/m)K(YNYi.. /-]i44M.
v`/,`|v]-DvLcfZ/eV/iDLN\D/ZK@%8W[Z.. `/d!Z8m
//,c\(2(X/NYNY8]ZZ/bZd\()/\7WY%WKKW) -'|(][%4.
,\\i\c(e)WX@WKKZKDKWMZ8(b5/ZK8]Z7%ffVM, -.Y!bNMi
/-iit5N)KWG%%8%%%%W8%ZWM(8YZvD)XN(@. [ \]!/GXW[
/ ))G8\NMN%W%%%%%%%%%%8KK@WZKYK*ZG5KMi,- vi[NZGM[
i\!(44Y8K%8%%%**~YZYZ@%%%%%4KWZ/PKN)ZDZ7 c=//WZK%!
,\v\YtMZW8W%%f`,`.t/bNZZK%%W%%ZXb*K(K5DZ -c\\/KM48
-|c5PbM4DDW%f v./c\[tMY8W%PMW%D@KW)Gbf -/(=ZZKM8[
2(N8YXWK85@K -'c|K4/KKK%@ V%@@WD8e~ .//ct)8ZK%8`
=)b%]Nd)@KM[ !'\cG!iWYK%%| !M@KZf -c\))ZDKW%`
YYKWZGNM4/Pb '-VscP4]b@W% 'Mf` -L\///KM(%W!
!KKW4ZK/W7)Z. '/cttbY)DKW% -` .',\v)K(5KW%%f
'W)KWKZZg)Z2/,!/L(-DYYb54% ,,`, -\-/v(((KK5WW%f
\M4NDDKZZ(e!/\7vNTtZd)8\Mi!\-,-/i-v((tKNGN%W%%
'M8M88(Zd))///((|D\tDY\\KK-`/-i(=)KtNNN@W%%%@%[
!8%@KW5KKN4///s(\Pd!ROBY8/=2(/4ZdzKD%K%%%M8@%%
'%%%W%dGNtPK(c\/2\[Z(ttNYZ2NZW8W8K%%%%YKM%M%%.
*%%W%GW5@/%!e]_tZdY()v)ZXMZW%W%%%*5Y]K%ZK%8[
'*%%%%8%8WK\)[/ZmZ/Zi]!/M%%%%@f\ \Y/NNMK%%!
'VM%%%%W%WN5Z/Gt5/b)((cV@f` - |cZbMKW%%|
'V*M%%%WZ/ZG\t5((+)L\'-,,/ -)X(NWW%%
`~`MZ/DZGNZG5(((\, ,t\\Z)KW%@
'M8K%8GN8\5(5///]i!v\K)85W%%f
YWWKKKKWZ8G54X/GGMeK@WM8%@
!M8%8%48WG@KWYbW%WWW%%%@
VM%WKWK%8K%%8WWWW%%%@`
~*%%%%%%W%%%%%%%@~
~*MM%%%%%%@f`
'''''
/************************************************************
* *
* .=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-. *
* | ______ | *
* | .-" "-. | *
* | / \ | *
* | _ | | _ | *
* | ( \ |, .-. .-. ,| / ) | *
* | > "=._ | )(__/ \__)( | _.=" < | *
* | (_/"=._"=._ |/ /\ \| _.="_.="\_) | *
* | "=._"(_ ^^ _)"_.=" | *
* | "=\__|IIIIII|__/=" | *
* | _.="| \IIIIII/ |"=._ | *
* | _ _.="_.="\ /"=._"=._ _ | *
* | ( \_.="_.=" `--------` "=._"=._/ ) | *
* | > _.=" "=._ < | *
* | (_/ \_) | *
* | | *
* '-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=' *
* *
* LASCIATE OGNI SPERANZA, VOI CH'ENTRATE * LEAVE EVERY HOPE, YOU COME IN
*************************************************************/
/**** 原文 *****/
// This was clearly written under duress
/**** 自譯 *****/
// 如果將來我讀到這篇文章,我會回到過去并自殺。
/**** 原文 *****/
// This was clearly written under duress
/**** 自譯 *****/
// 亂七八糟的 SQL語句,但它有效,所以請不要觸摸它
// .==. .==.
// //`^\\ //^`\\
// // ^ ^\(\__/)/^ ^^\\
// //^ ^^ ^/6 6\ ^^ ^ \\
// //^ ^^ ^/( .. )\^ ^ ^ \\
// // ^^ ^/\| v""v |/\^ ^ ^\\
// // ^^/\/ / `~~` \ \/\^ ^\\
// -----------------------------
/// 這是條龍
/**** 原文 *****/
// I from the future read this I'll back in time and kill myself.
/**** 自譯 *****/
// 這是垃圾代碼,但現在是凌晨3點,我需要把它修好。
// 我不確定我做了什么
如果你想被解雇,請將其刪除
// 切勿動以下代碼,否則我會踢你的 PP
作者:xor 譯者:前端小智 來源:medium 原文:https://medium.com/javascript-in-plain-english/30-funny-code-comments-that-will-make-you-laugh-1c1b54d4ab00
碼注釋的作用,不需要對程序員解釋了。有時在查看他人代碼,能看到一些令人不禁大笑的注釋。比如:
Wojtek Swiatek 的分享
我看過一些數據分析的代碼,然后就被下面的注釋震驚了:
# 不要再用 anal 做變量名了 # [ 譯注:寫注釋的人是想用 anal 這個縮寫來表示 analyze(分析),可是 anal 這個單詞的意思是 " 肛門 " ] # 我特么在哪都能看到 anal 這個詞!# 請不要再這么做了!# 你們要用就用 analyze,或者 xbvvzr,要不然用什么其他的都可以。就是別寫成 anal_insert 或者 anal_check 了 #【譯注:insert 是插入的意思,check 是檢查的意思,其他的你們自行腦補吧】
Anirudha Bose 的分享:
謝爾蓋.布林(Google的聯合創始人之一)在斯坦福大學念計算機科學博士學位的時候,他的簡歷里并不含任何”待遇要求“(Objective)的字眼。但當你去查看他的簡歷的HTML源代碼的時候,你會看到(他在簡歷HTML源文件里明確寫了“待遇要求”,只是用注釋注掉了,在瀏覽器頁面上不顯示。):
(其“待遇要求“的內容是:辦公室要大,掙錢要多,干活要少。如果能經常去奇妙的地方旅行而且還能給報銷的話,那就更好了。)
Abhinav Upadhyay 的分享
1 2 | /* You are not expected to understand this */ /* 我們并不指望你能看懂這段話 */ |
這段注釋并不是我親眼所見,但是它在網上傳得很厲害。這段注釋是出自于貝爾實驗室的Unix系統第六發行版,并在《Lions’ Commentary on UNIX 6th Edition, with Source Code》這本書中標注出來的。
代碼和標注的細節如下:
iu Wei 的分享[譯注:這明顯是一位來自中國的工程師]:
Michael Dehmlow 的分享
我新入職了一個公司,然后發現了一段三周之前寫的注釋,這段注釋是項目之前的研發團隊寫的,寫的日期就是我來公司面試和正式入職的這段期間。
我有幸在原來負責這個項目的先生們被炒魷魚的前一天被派來參與這個項目。
(本系列剛開始,還有后續,等著瞧 ~ )
、棧和隊列的區別是啥?吃多了拉就是隊列;吃多了吐就是棧
2、世界上最遙遠的距離不是生與死,而是你親手制造的BUG就在你眼前,你卻怎么都找不到她。
3、《c++程序設計語言》比《c程序設計語言》厚了幾倍。。。果然有了對象就麻煩很多。。。
4、怎么使用面向對象的方式變得富有?繼承。
5、為什么程序員總是分不清萬圣節和圣誕節?因為Oct31==Dec25。
6、Keyboardnotfound…pressF1tocontinue
7、提交代碼不寫注釋的人,小JJ就跟注釋一樣長
8、殺一個程序員不需要用槍,改三次需求就可以了
9、服務器按功能可以分為:數據庫服務器,web服務器,cache服務器,下片兒服務器等等。
10、四個2B青年掐架。
A:你丫等著,我爹是敏感詞!
B:Cao你大爺!你丫牛B神馬,我爹在網上搜索根本無法顯示!!
C:我爹404notfound!!!
D:我爹ConnectionReset!!!!
11、一同學問我,軟件外包是什么。解釋了幾句還沒明白,遂想了一下:包工頭知道吧?頓悟!
12、十行代碼九個警告八個錯誤竟然敢說七日精通六天學會五湖四海也不見如此三心二意之項目經理簡直一等下流。
13、一個程序猿在肉店買了1公斤肉,回家一稱,他不高興的跑回肉店對老板說:少了24克……
14、網絡聊天的時候,想表達對方是豬,一般人會打“xxx你這個豬。”,程序員會打xxx.isPig=TRUE。
15、兩個程序員,一個技術精湛,思維嚴謹,認真負責,Bug極少,至今單身;
一個技術一般,吊兒郎當,Bug一堆,經常被測試MM叫到她旁邊,接受批評,后來成了她男朋友。。。.。.
16、寶寶數學很好,2歲就可以從1數到10了。后來,我告訴他0比1還小。
今天吃餃子,我說:“寶寶,你數數你想吃幾個餃子?”
“0,1,2,3。”一邊說著一邊拿起一個餃子,“這是第0個。”
老婆怒吼:“下一代還是做程序員的命!”
17、程序員找不到對象,一般有三種情況:
●C#、JAVA都有對象,但是經常找不到對象。
●ASMC直接沒有對象。
●javascript都是偽對象,最多算曖昧。
但C++日子一直都好過,因為C++是多繼承,富二代呀!!!
18、程序猿:我的第一個問題是,對于我第二個和第三個問題,你可不可以只用‘能’和‘不能’來回答?
老板:“OK!”
我的第二個問題是,如果我的第三個問題是我能不能漲工資?那么你對于我的第三個問題的答案能不能和第二個問題的答案一樣?
老板:。。。。。。
19、假如生活欺騙了你,找50個程序員問問為什么編程;
假如生活讓你想死,找50個程序員問問BUG改完了沒有;
假如你覺得生活拮據,找50個程序員問問工資漲了沒有;
假如你覺得活著無聊,找50個程序員問問他們一天都干了什么!
20、c程序員看不起c++程序員,c++程序員看不起java程序員,java程序員看不起c#程序員,c#程序員看不起美工,周末了,美工帶著妹子出去約會了…一群傻X程序員還在加班!
21、客戶被綁,蒙眼,驚問:“想干什么?”
對方不語,鞭笞之,客戶求饒:“別打,要錢?”
又一鞭,“十萬夠不?”
又一鞭,“一百萬?”
又一鞭。客戶崩潰:“你們TMD到底要啥?”
“要什么?我幫你做項目,寫代碼的時候也很想知道你TMD到底想要啥!”
22、“這位同學,請問你知道《邊城》嗎?”“呸!別跟我提編程,老子這輩子最討厭的就是編程!”
23、摘自雷登書屋數據處理字典:死循環:n.,見無限循環。無限循環:n.,見死循環。
24、一個人正吸著雪茄,吐著煙圈。他女朋友生氣了發飆道,“你沒看見包裝盒上的警告么?吸煙有害健康!”那人回答道:“我是程序員。我們不關心警告,只關心錯誤。”
非常感謝你的閱讀
*請認真填寫需求信息,我們會在24小時內與您取得聯系。