手机浏览 RSS 2.0 订阅 膘叔的简单人生 , 腾讯云RDS购买 | 超便宜的Vultr , 注册 | 登陆
浏览模式: 标准 | 列表分类:Misc

阅读代码真的很难

在转载这一篇文章之前,我想,做为一名开发人员,或多或少总得读过多少代码的吧。读代码之前有感觉一亮的代码,也有让你看的很郁闷的代码吧?
如果仅仅是学习,你或许还会放弃那些读的很郁闷的代码,可是如果你是在工作中,你在做二次开发的时候,你遇到那些让你郁闷的代码你怎么办?忍着,不断忍着,然后得继续看下去。

恩。看看人家微软的人怎么说的:
编者按:原文作者Eric Lippert是一名资深软件设计工程师,从1996年起一直在微软开发部门任职,协助设计并实现VBScript、JScript、JScript .NET、Windows Script Host、Visual Studio Tools for Office 和 C#。

Escalation的工程师JeremyK在他博客中问到:

你是怎么教人们快速深入挖掘不熟悉的代码(不是自己所写的)?我学习如何编程的方法很传统 —— 自己动手编码。但我现在很纠结:到底是集中精神阅读源码,还是自己编写。对我而言,似乎唯一有效的方法就是自己写过。

不是和Jeremy开玩笑,写代码的确没有读代码难。

首先,我同意你的看法,几乎很少有人能读代码但不会写代码。这不像自然书面语或口语,理解他人的意思并不需要去理解他们为什么要那样说。比如,如果我说:

“写代码有两种方式:一种严格且详细,另一种模糊且草率。前者生成简洁分层的婚礼蛋糕,后者却是意大利面条。”

上面这句话产生一个平衡且幽默的效果,但即使听众和读者不理解我使用“零照应”和“并列句”这样的文字技巧,也会理解我要说的意思。但是说到代码,既要从代码本身中理解代码作者的意图,又要理解代码产生的预计效果,这两者都极为重要。

因此,我又回到那个问题了,有些人需要快速切入代码,但不需要动手写代码,那我们如何编写适合这些人的代码?

下面是我在编写代码时,尽力去做的事,目的就是使其他人能轻松阅读:

  • 使代码遵从工具。Object Browsers和Intellisense虽然很好,但我告诉你,我是守旧派。如果找不到我想要的,我会不高兴。什么使得代码成为可查询的呢?
    • 像"i"这样的变量名不好。如果没有明确的错误提示,你就无法轻易查找代码。
    • 避免使用是其他名字前缀的名字。比如,在代码中有个“perfExecuteManifest”,如果再有一个“perfExecuteManifestInitialize”,这就会让我抓狂,因为每次在源码中查询前者时,我不得不费力地过滤掉后者所有的实例。
    • “临时传递数据”(tramp data)应使用相同的名字。所谓“临时传递数据”(tramp data),就是指那些传递给方法A的变量,还要传给方法B的变量。这两类变量实际上是相同的,所以如果它们有着相同的名字,则更好。
    • 别用宏来重命名东西。如果有个方法叫get_MousePosition,那别这样GETTER(MousePosition)来声明该方法。因为我会找不到实际的方法名。
    • Shadowing会引起很多问题,请不要用它。
  • 坚持使用一种命名模式。如果你打算用匈牙利命名法,那就坚持并广泛使用,否则将适得其反。使用匈牙利命名法来记录数据,而不是存储类型;记录普遍事实,而不是临时条件。
  • 使用断言来记录先决条件(preconditions)和后置条件(postconditions)。
  • 别缩写英文单词。确切来说,别缩写成稀奇古怪的形式。在脚本引擎中,有个变量名叫“NME”,这让我非常抓狂!它应当叫“VariableName”。
  • C语言标准运行时库的设计不是很优秀。别去效仿它。
  • 别写“聪明”的代码;当代码出现问题,维护代码的程序员没时间去理解你的聪慧。(编注:这条建议即为:编写可维护的代码,详情可参见《明星软件工程师的10种特质》中的第8点。)
  • 理解编程语言特性的设计初衷,使用这些特性去做它们适合完成的工作,而不是它们能做到的工作。例如:别把异常当做一般的流控制机制来使用(即便你能做到),而应该用它们来报告错误。别强制把接口指针转换成类指针,即便你知道这样没问题。
  • 按功能单元划分源码树,而不是按组织结构。比如:我目前所在团队中,有2个根子目录的名字是 “Frameworks”和“Integration”,这是两个团队的名字。不巧的是,Frameworks团队名下有一个叫“Adaptor”的子目 录,而“Adaptor”却是Integration的子目录,这就非常令人迷惑。同理,(如果)有着相同子目录的不同的子树,有些是客户端的组件,有些 是服务端的组件;有些是管理组件,有些是非管理组件;有些是处理型组件,有些是非处理型组件;有些是零售组件,有些内部测试工具。这就会乱七八糟的。


当然,我实际上根本没有回答Jeremy的问题——如何调试不是我写的代码?

这取决于我的目的。如果我只是因为一个bug,而深挖一段具体的代码,我会在调试器中逐步跟踪所有代码,写下我“走过”的调用分支,记录下哪些方法是 特定数据结构的“生产者”,哪些方法是“消费者”;我也会仔细盯着输出窗口,查看出现的有用信息;还要打开异常捕捉器,因为异常通常是问题所在。设置断 点;我会记录所有和我上面建议相反的地方,因为这些东西很可能误导了我。

如果我想在理解一段代码后修改它,我通常是从代码头部开始,或者先查找公共方法。我要知道类是如何实现的,它是如何扩展的,它的作用,它是如何嵌入整 个代码中的?我会尽力理解这些东西后,才去了解这些特定部分(代码)是如何实现的。这耗时虽更长些,但如果你准备改动复杂代码,你应当那样做。
译文出处:伯乐在线 - 职场博客
译文链接:http://www.jobbole.com/entry.php/438

原文作者:Eric Lippert  编译:伯乐在线 敏捷翻译组 - 关关

--EOF--

我承认,我写过垃圾的代码。更垃圾的代码也写过。。。。。
我希望我未来写的会好一点。最起码,自己看的不难受吧。。。
所幸,在写过那么久的代码后,我现在看代码的速度也可以接受了,也能够忍受各种各样的代码。

Tags: 阅读

乱七八槽

闲在家里居然连博客也写的少了。嗯。是抄的少了。。。
所以记录点东西吧。。。
1、Yii的语言包。参考官网GUIDE中i18N的说明。如果要最方便的处理,那就是在config里设置language为zh_cn,这样所有的出错信息都是中文了(让我郁闷的是,好象主框架里的文件是GBK的?)如果中途需要变更语言,则直接在URL里加入?language=en_us之类的。关于localID,在i18N一章有介绍。如果是自己的程序中的语言包,那就是直接在/protected/messages目录下建立localID的目录,同时写入你的语言包分类的名称,比如我建了一个system.php,那么我在Yii里的调用就可能是如下的: Yii::t("system","要翻译的内容");第一个参数对应了文件,第二个就是语言包中的名字,可以有参数,可以很多。。。请查看手册

2、学着做PPT,发现WPS的模版库还是不错的,然后看到这个博客:http://blog.sina.com.cn/changshappt,觉得哇,好厉害啊。。。

3、前两天说我收藏了一些做WEB的小工具,其中就有配色方案的,如果需要可以去下载。当然现在我说的是在线版的,地址在这里:http://www.mb5u.com/tool/peise/。其实可以把它COPY到本地的,但我目前还是想着算了。。

4、做PPT的时候参考的文章之一:浅谈各浏览器的Javascript引擎。来自于http://blog.csdn.net/maco_wang/archive/2009/11/02/4758573.aspx,主要借鉴了以下的内容:

1、Chrome浏览器的V8 Javascript引擎,使包含大量Javascript的网页装载速度提高30%。
2、Opera宣布新JS引擎"Carakan" 速度提升2.5倍。
3、Firefox 3.5拥有一个全新的JavaScript引擎,叫做TraceMonkey,在该引擎上跑JS应用要比Firefox 3快到3-4倍。
4、safari浏览器新的js引擎squirrelfish非常快。
5、傲游浏览器3.0.3.3 alpha JS引擎升级,脚本执行速度提高9%。

郁闷:装了一夜的操作系统

刚到手的一体机换操作系统让我折腾了一个晚上。
其实最主要的问题并不在于操作系统,而是在于那个系统分区(长这么大没见过1T的硬盘一下子太大了我受不了了)
对于机器也有一些初体验:
1、无线的键盘和鼠标确实让人眼前一亮,最起码方便了很多,象这种一体机的目标本来就是为了让线少一点,现在更少了
2、硬盘的声音不小,可能是因为在上面 的关系。直接面对着,感觉比较强烈,以前机箱都在地上,感觉没有现在强烈。
3、win7下的驱动不太全。显卡驱动居然默认认不出的。非得装个驱动人生才 OK。现在在找前置摄像头的驱动了。。。
4、显卡温度较高,不知道装了驱动后会不会好一点。还没有折腾过总体感觉还行,没有想象中那么差。只是不知道夏天 散热怎么样了。毕竟都放在一起,用的也是台式机的硬盘。不过昨天看鲁大师的时候,硬盘温度和CPU温度都一般,就显卡温度高了一点,估计应该可以挺过去缺 点是。散热孔在最上方,这里也就是以后灰尘最多最容易沾染的地方了。

硬盘是挺大,然后就带来了一些问题。。。
安装win7的时候,我采用了默认安装,结果在C盘前多出了100M的系统分配空间,查了网上的一些资料,发现这100M的空间其实挺有用,我在C盘上好象依稀记得可以attach VHD之类的。记不清了。
搜索 100M隐藏分区(http://www.google.com/search?q=100M%E9%9A%90%E8%97%8F%E5%88%86%E5%8C%BA&ie=utf-8&oe=utf-8&aq=t&rls=org.mozilla:en-US:official&client=firefox-a),可以查到很多资料。我就不一一说明了。
反正为了这100M我折腾了很久啦,因为我不想要这100M空间。。
大致介绍一下我的过程
1、先安装一遍 ,发现装错了,装了64位的。好吧,重开始折腾。。
2、第二遍,装了32位的,嗯。多了100M,所以想去掉它
3、启动的时候删除所有分区,结果发现。。。那100M居然无法删除(用win7启动盘启动的)
4、换光驱启动,换 成linux启动,删除所有分区,保留根分区
5、重装win7,格式化所有硬盘,安装,结果进系统后又发现多了100M
6、继续折腾,怎么办呢?嗯,用分区大师,结果装了很多种,ParginMagic 7不支持win7 ,OO partaion进去后,不小心把C盘 设为活动的,然后就再也不能操作了。装 partationmagic最新版,可以操作提示重启
7、重启后发现ntdlr不见了。系统没了。。靠,继续重启,这时候想办法用winPE了,用winpe启动分区,分成四个主分区,最后150G空着准备做其他的(winpe不能分逻辑区。。。晕 )
8、重装进去后,这回是没有100M了,嗯开始装软件,装了一部分后想起来,150G还没有折腾它,在磁盘管理里操作,提示我如果把这个分区设为活动的,将不能在上面安装操作系统,嗯。我同意,我不会在最后一个分区上装操作系统的。等我确认后,发现。。。所有的分区都变成活动分区了。也就是说,我的C盘将不能启动?测试一下。。。
9、重启,果然不能启动了。。。继续第8步的操作。我这回只要四个主分区,不要其他分区了。NND
如此折腾,已经到了凌晨三点了。累啊。

一体机

昨天订购的20寸的一体机,今天就到货了。。装系统中,不说别的,先上图吧。总体来说还是比较满意的。只是自带的redflag操作系统也太烂了。或者是我自己水平烂吧,看着那模拟的win界面,怎么着都感觉不舒服 。。。
所以,只能自己把它咔嚓了,装个win7折腾一下。。。
IPOD拍的照片不太清楚。将就一下下吧

晚上拍的,啥时候白天拍一下,颜色啥的都看不清楚


大小: 160.53 K
尺寸: 500 x 375
浏览: 1796 次
点击打开新窗口浏览全图
家中的两台电脑
大小: 157.64 K
尺寸: 500 x 375
浏览: 1747 次
点击打开新窗口浏览全图
单独一台机器
大小: 169.86 K
尺寸: 500 x 375
浏览: 1757 次
点击打开新窗口浏览全图
正面对比大小

昨天买的就是这一台:
 

Tags: 一体机, hp

买了一台一体机

最近这段时间休息在家里,因为要写代码,原来的12寸的笔记本屏幕太小了,于是就萌生了要买一台台式机的想法。
毕竟,众所周知的,台式机嘛,同样价格的情况下,性能要优于笔记本。嗯,更重要的是,屏幕大了,屏幕大的好处就太多了。比如我的IDE,就可以看的更舒服,而不至于像现在,IDE一开,可视的范围就剩一点点大了。。。几乎无法写代码,郁闷啊。

最终,我选择了两台电脑作为挑选,没有选择imac。实在是没钱了。买imac的钱,可以够我买两台台式机了。我也没有选择普通的台式机,因为老婆觉得家里再堆一个机箱,有N多线连着很烦人。所以我在选择了很多电脑之后,确认了两台机器,那就是:

 


这两台电脑其实我是比较偏向于后一台,因为,他是4G内存,我就无所谓再添加2G内存了,而且23寸的屏幕,也可以让我看的很爽。然而,京东上,这一台电脑一直没货。。。太郁闷了。最终我买了前面一台 5139cx,缺点是只有2G内存,其他我也就忍了。其实还有一款3699的HP20寸的电脑,但是那台电脑的鼠标是有线的,键盘也是,所以我最终还是确认这一台了。。

下周开始,我的开发速度估计又会上升一点了,毕竟笔记本开发,12寸,1024*768的分辨率也太低了。。。当然有钱的话,我是会考虑imac。。

Tags: 一体机, hp