让别人读懂你的代码

2010 年 10 月 23 日
 xhacker
原先一直是自己写东西。

最近加入了一些开源项目。
自己的一些所谓的“项目”也有了别人接手。

别人的代码对我来说总是恐怖的。
相信我的代码对别人来说也是恐怖的。

……
所以，
能让别人读懂你的代码，
估计是最高境界了。
6562 次点击
所在节点    随想
7 条回复
no2x
2010 年 10 月 23 日
注释 是必须也是很重要的。开发文档，最好有文件简介。
darcy
2010 年 10 月 24 日
的确，要想代码写得优雅不是一朝一夕的事情
FRHong
2010 年 10 月 24 日
http://liuming.javaeye.com/blog/776890

You might be interested in this :)
ratazzi
2010 年 10 月 24 日
现在觉得命名非常的重要，好的命名基本上不需要什么注释，主要是针对 PHP 来说，比如 Magento 的代码比起那些 vanilla 好读很多。
Sam
2010 年 10 月 24 日
想起那个搞笑的注释：
只有上帝和我看得懂。
现在，只有上帝看得懂了。


刚学编程的时候写的代码，从不注释，过了几天，自己都看不懂了。
lik
2010 年 10 月 24 日
编程就是和机器以及人类交流（项目合作者、几天后的自己）啊。
cellsea
2011 年 1 月 12 日
为什么我从来都看得懂自己的代码呢？ 我从来不写注释的。。。 是我写的代码太简单了吧？？。。。

这是一个专为移动设备优化的页面（即为了让你能够在 Google 搜索结果里秒开这个页面），如果你希望参与 V2EX 社区的讨论，你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://study.congcong.us/t/3681

V2EX 是创意工作者们的社区，是一个分享自己正在做的有趣事物、交流想法，可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX