IT技术博客大学习 共学习 共进步
全部 移动开发 后端 数据库 AI 算法 安全 DevOps 前端 设计 开发者

10个最“优秀”的代码注释

外刊IT评论 2011-11-23 23:52:49 累计浏览 4,765 次
本机暂存
本刊评论

    下面是stackoverflow网站上网友针对你看到过的最好的代码注释是什么样的?这个问题给出的回答的前10条:

  • // 亲爱的维护者:
    // 如果你尝试了对这段程序进行‘优化’,
    // 并认识到这种企图是大错特错,请增加
    // 下面这个计数器的个数,用来对后来人进行警告:
    // 浪费在这里的总时间 = 39h
  • /** * 致终于来到这里的勇敢的人:
        你是被上帝选中的人,英勇的、不辞劳苦的、不眠不修的来修改
    我们这最棘手的代码的编程骑士。你,我们的救世主,人中之龙,
    我要对你说:永远不要放弃,永远不要对自己失望,永远不要逃走,辜负了自己。
    永远不要哭啼,永远不要说再见。永远不要说谎来伤害自己。 */
  • Exception up = new Exception("Something is really wrong."); throw up; 
  • // 一些修改1 - 2002/6/7 增加临时的跟踪登录界面
    // 一些修改2 - 2007/5/22 我临时的犯傻
  • #define TRUE FALSE //逗一逗调试程序的傻瓜们
  • if (/*you*/ $_GET['action']) { //celebrate(恭喜)
  • // 如果这段代码好用,那它是Paul DiLascia写的。
    //如果不好用,我不知道是谁写的。
  • //写这段代码的时候,只有上帝和我知道它是干嘛的
    //现在,只有上帝知道
  • // 晕了,以后再修改
  • // 神奇。勿动。
  •     你有没有更绝的?

    同分类推荐文章

    1. 科技爱好者周刊(第 401 期):如何赚到10亿美元 (2026-06-26 08:05:38)
    2. 如何做决策 - 从 Go 的一个 issue 说起 (2026-06-26 08:00:00)
    3. Seven Player:Windows上播放115网盘视频的增强工具 (2026-06-09 00:06:47)

    查看更多 开发者 文章 →

    建议继续学习

    1. 提高代码可读性的注释技巧 (累计阅读 8,169)
    2. 怎么样才是好的程序员 (累计阅读 7,742)
    3. 程序员和工程师有什么不一样? (累计阅读 7,518)
    4. 如何避免重构带来的危险 (累计阅读 4,637)
    5. 陪伴我作为程序员的9句名言 (累计阅读 4,417)
    6. 程序员的五个阶段 (累计阅读 4,191)
    7. 关于《代码大全2e》 (累计阅读 4,174)
    8. 谈谈年度最佳代码“不管你们信不信,反正我信了” (累计阅读 4,129)
    9. 如何写出无法维护的代码 (累计阅读 4,020)
    10. 加班不加班 (累计阅读 3,637)