发现很多人写代码没有很好的 design ,没有 document 没有 test, 没有 test coverage , 没有 sphinx。

2014-11-01 13:33:36 +08:00
 nooper
写的项目只有自己明白,剩下的基本没人看的懂。
structure of your code should avoid reference cycles.
better variable naming.
哎呦,我实在搞不懂code quality, 不是写出来多么牛B的算法,多么牛逼的技术,而是你的东西能够被人看懂,能够让他人学习。
即便是最简单的代码,也要很整洁,高质量的代码是消除复杂的结构,和混乱的代码。
而不是写的多么复杂,不是用行数来衡量的。
看来大部分人普遍需要提高质量,同样我也需要。
木哈哈哈。
5769 次点击
所在节点    程序员
53 条回复
andychen20121130
2014-11-01 16:15:54 +08:00
为了让老板看不懂啥也不写。
andychen20121130
2014-11-01 16:16:03 +08:00
哈哈。。。。。。。。。。
em70
2014-11-01 16:19:49 +08:00
你写代码是为了让他人学习么,大都是为老板赚钱,能实现功能就可以了。文档齐全,代码工整,这是个人素质而已。
messense
2014-11-01 17:28:12 +08:00
以前也很随意,现在倒是努力认真写了。Example:

https://github.com/messense/wechatpy

One man work. 话说 Travis CI、Coveralls、ReadTheDocs 和 Scrutinizer CI 这些集成 GitHub 的工具真的不错。
nooper
2014-11-01 17:48:27 +08:00
@messense 没有代码注释没有注释的代码不能称为好代码,看了一下代码的质量可以。没有细看
messense
2014-11-01 17:50:39 +08:00
@nooper 写的时候公司项目赶着用,注释写得就比较少,而且本身逻辑也比较简单啦。
nooper
2014-11-01 17:58:38 +08:00
@messense 基本没有注释。哪怕是再简单的逻辑也要有注释。好的习惯和好的细致程度能看清楚一个人的真正的品质。numpy pandas都有注释。任何一个伟大的项目的成功都是源于细致和良好的素养。我总算认识到这一点,项目再赶,说明公司的流程和文化上就没有培养人的意识
nooper
2014-11-01 18:03:34 +08:00
@em70 我写的任何一个项目都可以成为开源项目。我的意思不是说在Github上开源。开源项目是有开源项目的标准的。这是我要努力和致力的。
messense
2014-11-01 18:05:55 +08:00
@nooper 是啊,公司大部分时候都是在赶项目......不过注释是有一点的...为了用 Sphinx 自动生成类的文档特意加的......也是希望能有时间完善,但是精力暂时有限。能养成好的习惯自然是很好的事情,做起来阻碍还是挺多的。继续努力呗。
nooper
2014-11-01 18:08:54 +08:00
@messense 希望加上哈哈。逼死人的节奏肯定离职。
em70
2014-11-01 18:13:42 +08:00
@nooper 职业程序员的代码版权属于公司的啊,不能你说开源就开源。
nooper
2014-11-01 18:16:46 +08:00
@em70 我自己的项目啊,跟公司无关
ilili
2014-11-01 20:20:34 +08:00
我觉得楼主说的就是我这样的。。。
songco
2014-11-01 22:54:06 +08:00
根据我们公司的几个美帝高级码农的代码(差不多都有15+年的经验, 职位比较高, 但是都还是一线码农), 不写注释什么的基本上问题不大, 他们的代码都非常清晰好懂. 不过他们的test非常多.

另外我做过的另一个用c写的比较底层的项目, 基本上只用比较小的精英团队, 也没注释unit test之类的, 项目质量还是非常好的. 不过大部分项目都没办法只用水平比较好的程序员, 比如我在同一个公司的另一个项目就比较惨, 老大给我分了好几个应届生(学校都不错, 基本都是国内排名前10的..),我不太想要, 老大直接来了句, 我给你的人不是人吗? 项目比较紧, 新人没时间人力去培训, 又不能闲着, 让写代码吧, 你review/修改代码/fix bug的时间比他写代码的时间还要长, 让他们先去管理服务器吧(我们项目的服务器比较多, 组里大概有几百台), 他们的经验又不够, 做做测试吧, 我们测试:开发比例已经1:1了...
lzmbbg
2014-11-01 23:31:55 +08:00
做个标记,做个记录,自己能找到就行了。大部分时间都是这样。
coofly
2014-11-01 23:36:22 +08:00
有个理念是:
需要注释说明你的函数、变量命名不够明晰,说明你的结构不够清楚。
好的代码自己会说话,不会说话的代码请回家重构去。
timbotetsu
2014-11-01 23:39:54 +08:00
@nooper 没有代码注释没有注释的代码不能称为好代码

我个人认为代码即文档,希望别人看到我的代码的时候只要扫一下我的方法名就知道我这个方法是做什么的,变量名代表的意义
因为在工作中别人会看到我的代码,所以我会积极的把代码写得更好一些,反而对自己非工作时候写的代码得过且过(因为没人看ry
nooper
2014-11-01 23:40:07 +08:00
@coofly 错误。
coofly
2014-11-02 00:09:48 +08:00
@nooper 请证明
coofly
2014-11-02 00:12:45 +08:00
@nooper 好吧,不需要证明什么,这种问题其实挺主观的
只希望你知道有这种观点存在就好了

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

https://www.v2ex.com/t/143162

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

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

© 2021 V2EX