Miss_love 发表于 2015-1-7 11:39:52

【我分享】“优秀”的代码注释

本帖最后由 Miss_love 于 2015-1-7 11:59 编辑

下面是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]
查看完整版本: 【我分享】“优秀”的代码注释