译者注:这是一个来自 Stackverflow 上的问题,问题由于不符合 Stackoverflow 的社区规则,现在已经被关闭了; 之前也有别人翻译过,可是现在能搜到的翻译要不零散,要么翻译得不准确,我们特意选取了二十个来翻译,一起看看其中汇集了各式各样好玩的注释!


1.来自@Jens Roland,得票数:1468
对于注释,我总是感到愧疚,因为我总喜欢把非建设性的评论、代码诗和一些小笑话放到我自己的大部分项目中(尽管我自己认为会有足够的感知,能在代码发出去前删除掉明显冒犯性的内容)。这里是一个我自己特别喜欢的,放在很隐秘的地方且设计槽糕的"上帝对象"(God Object):

/**
* 至那些勇敢地探索到此处的伟大灵魂:
* 你就是那个冥冥中被选中的那个人,那个不懈地斟酌修改我们那些极其糟糕的代码的人,像是一个在编程世界里英勇的厮杀的骑士!
* 对你,对你这个真正的救世主,对你这个人类的王者,我郑重的说:
* never gonna give you up, never gonna let you down,
* never gonna run around and desert you. Never gonna make you cry,
* never gonna say goodbye. Never gonna tell a lie and hurt you.
* (译者注:上面三句不翻译,其实是因为那是一首歌的歌词)
*/

我很抱歉!!我实在忍不住不这么做啊...!!
另外,还有一个,不过我并没有把它放出来,尽管我很想!!它存在于我写的一些不那么直观的类里面:

//
// 亲爱的维护者:
// 当你优化完这个程序时,你会明白你所做的优化是一个多么大的错误;
// 请自觉在下面的累加器上留下记录,以提醒后来者:
//
// total_hours_wasted_here = 42
//


2.来自@benmatth,得票数:1058

Exception up = new Exception("真的出问题了!");
throw up; //哈哈哈哈


3.来自@johnc,得票数:1055

//当我写下这些的时候,只有上帝和我知道我在做什么。
//现在,只有剩下上帝知道了。


4.来自@Tuoski,得票数:1052

stop(); // Hammertime! (译者注:这里的代码和注释其实连起来是一句很有名的歌里面的歌词)


5.来自@Ash,得票数:1034
这是为了防止某些笨蛋把我的代码混乱....

// 这是自动生成的,请不要改变它。所有的改变将会被还原。


6.来自@Sergey Kornilov,得票数:949

// 有时候,我相信编译器会忽略我的全部注释


7.来自@sharkin,得票数:933

//我把这所有的代码、我所有的工作,奉献给我的妻子,Darlene,
//因为一旦这些代码被公开,她将不得不独自抚养我们的三个孩子、我和一只狗。


8.来自@Tom Ritter, 得票数:916

// 为了保护傻逼,这些代码已经"消毒"过了
using System;
using System.Collections.Generic;
using System.Text;
using System.Reflection;
using System.Web.UI;

namespace Mobile.Web.Control
{
///


/// 这是一个为配合那个名为 Richard 的傻逼工作的类!
///

/// (附注)
/// 这是为了能让他那些设计糟糕的东西能在移动设备上正常工作,
/// 主要的问题是他想那个 BindCompany() 方法能做任何事情,
/// 我无奈得希望他死了。
///

public abstract class RichardIsAFuckingIdiotControl : MobileBaseControl, ICompanyProfileControl
{
protected abstract Pager Pager { get; }

    public void BindCompany(int companyId) { }

    public RichardIsAFuckingIdiotControl()
    {
        MakeSureNobodyAccidentallyGetsBittenByRichardsStupidity();
    }

    private void MakeSureNobodyAccidentallyGetsBittenByRichardsStupidity()
    {
        // 确保没有人会这真正使用那个傻逼 BinCompany 方法
        MethodInfo m = this.GetType().GetMethod("BindCompany", BindingFlags.DeclaredOnly | 
            BindingFlags.Instance | BindingFlags.Public | BindingFlags.NonPublic);
        if (m != null)
        {
           throw new RichardIsAFuckingIdiotException("No!! Don't use the fucking BindCompany method!!!");
        }
        // P.S. 这个方法只是一个玩笑, ... 下面那些就是来真的了。
    }

    /// <summary>(概括)
    /// 如果你希望这个控制语句能在这个请求内处理所有的事情,它就会返回真。  
    /// Richard 认为每次请求时重新加载整个网站的想法很好,认为进程事件应该自己结束自己;
    /// 他还认为头巾和飞行员眼镜是极其的奇形怪状的,哥们。
    /// </summary>
    protected bool IsThisTheRightPageImNotSureBecauseRichardIsDumb()
    {
        return Request.QueryString["Section"] == this.MenuItemKey;
    }

    protected override void OnLoad(EventArgs e)
    {
        if (IsThisTheRightPageImNotSureBecauseRichardIsDumb())
        {
            Page.LoadComplete += new EventHandler(Page_LoadComplete);
            Pager.RowCount = GetRowCountBecauseRichardIsDumb();
        }
        base.OnLoad(e);
    }

    protected abstract int GetRowCountBecauseRichardIsDumb();
    protected abstract void BindDataBecauseRichardIsDumb();

    void Page_LoadComplete(object sender, EventArgs e)
    {
        BindDataBecauseRichardIsDumb();
    }

    // 剩下的的他那些累赘的接口成员
    public abstract string MenuItemName { get; set; }
    public abstract string MenuItemKey { get; set; }
    public abstract bool IsCapable(CapabilityCheck checker, int companyId);
    public abstract bool ShowInMenu { get; }
    public virtual Control CreateHeaderControl()
    {
        return null;
    }
}

}

更新:对这份代码的原作者也做了自己的声明,我也会把他这应得的 credit 送出去。 我进去Dan McKinley在的公司后,很快他就离职了。他对我说了更多的关于那份代码的背景和别的 Richard 写的"令人爆粗"的代码。


9.来自@Rohit,得票数:830

// 少许修改1 - 2002/6/7 增加临时地跟踪登录界面的设置
// 少许修改2 - 2007/5/22/ 临时个毛!


10.来自@Daniel Papasian, 得票数:728

// 我喝醉了,迟些再修改。
我希望那时候我是在开玩笑;但我知道其他开发者这样写时,我认为那是认真的。


11.来自@Jason Sundram, 得票数:722

//里面有魔法的,别修改。


12.来自@Sulik, 得票数:703

#define TRUE FALSE //祝你找BUG愉快,笨蛋!


13.来自@Greg D, 得票数:641

// 很抱歉..


14.来自@Lateral, 得票数:637

return 1; #returns 1


15.来自@Draemon, 得票数:593

/* 这里时间复杂度为 O(scary), 但在实际应用中看起来足够快 */

接着是四个内嵌的for 循环语句...


16.来自@Randyaa, 得票数:509

Catch (Exception e) {
//谁真会关心这个?
}


17.来自@martinus, 得票数:496

/**
* 总是返回真的!
*/
public boolean isAvailable() {
return false;
}

永远不要相信注释......


18.来自@PoppaVein, 得票数:458

/*
* 你或者会觉得你知道下面这些代码是做什么的。
* 但你不会知道的,相信我。
* 瞎搞瞎改,你得到的只是很多个不眠之夜,你不要以为你很聪明,能"优化"下面那些代码。
* 关掉这个文件,玩别的去吧。
*/


19.来自@gedevan, 得票数:431

try {

} finally { // 按道理说,这个不应该发生。

}


20.来自@Juliano, 得票数:355

long long ago; /* 在那遥远浩瀚的银河深处... */



还有更多的注释可以直接去原问题下面翻。

本文由 SegmentFault 倾情翻译!

如果觉得我的文章对你有用,请随意赞赏

tclh123 · 2013年11月28日

笑尿...
.

回复

ShingChi · 2014年01月01日

我记得 kissy 的注释也很另类~~

回复

载入中...
JeOam JeOam

7.5k 声望

发布于专栏

SegmentFault 业界资讯

为广大开发者提供关于开发行业的相关技术媒体资讯

360 人关注