澳门新葡亰平台官网好代码如文档,不言自明

by admin on 2020年4月27日

澳门新葡亰平台官网 1

原文出处:
freecodecamp   译文出处:程大治   

澳门新葡亰平台官网 2

好的代码,就像是好的笑话——无需解释就能让别人明白。如果你的代码能够做到不解自明,在大多数时候,你根本无需为其配备说明文档。 

好代码像好的段子,不需要多余的解释。

一些酷炫到炸裂个人网站分享;一个女程序员职场自述;css3
几步即可实现loading动画效果;探索 CSS3 中的 box-shadow 属性;javascript
高级编程;浅析JavaScript的沙箱内容

好的代码,就像是一辆配备了优秀音响和杯架的汽车,这辆车在行驶到最高速度的时候,你听不到噪音,也不用担心水会洒出来。在它出现故障的时候,任何一名修理工都可以使用最常见的工具,在最短的时间里轻松将其修好。 

如果你的代码是不解自明的,那么大多数情况下,它并不需要注释和文档。

9月21日 13:15IT程序狮(20次阅读/2次分享/1次评论/1次点赞)

而坏的代码,就像是一辆向你承诺最高速度可以达到200MPH,但是音响只能播放老式的磁带,而且杯架还不稳的车。你在调整反光镜角度的时候,汽车都会突然出现故障,而且一般的修理工还修不了这辆车,必须要找专家,让专家在生产线上使用专业的工具来修理。 

好代码就像一部好车,轻轻松松飚到最高时速。当出了问题,任何修补机制都能将它推进车库,以很简单的工序,使用基本的工具将其修复。而烂代码就像一辆车,它声称可达200MPH,但音响只能播磁带,放置杯子的地方也满是污点。每当你尝试调整后视镜,车都多少起点火,而且必须得特定人员来,在高档流水线上,使用来自星星的工具将车再拼起来。

#UI设计#详见:
总有一些牛X的设计师,他们敢于脱离信念的束缚,将设计理念以及手法发挥到极致。今天分享的这些网站,相信它们会给你更多的灵感与启发。[熊猫]

好代码像是一本写作技巧高超的人所写的书


1.容易理解

2.分章明确,每一章都有清晰的主旨

好代码就像一本好的教科书

  • 简单易懂。
  • 很精巧的分成章节,每章每节都有不同的意义。

9月21日 13:30程序员俱乐部(15次阅读/8次分享/3次评论/11次点赞)

而坏的代码像是刚刚学会写字的人所写的书


=””>1.各个章节之间纷乱复杂,每一章都没有明确的主旨

2.连篇累牍的重复一句话,而且毫无缘由

=””>3.作者在一开始设定了一些规则,但是在后面的内容中却自己不断的违反这些规则

=””>4.突然间书里出现了一个吸血鬼,而且还能在白天出来吸血。

烂代码就像写的很烂的教科书

  • 章节之间互相引用,而又搞不清每一节说的是什么。
  • 不停地说同样一件事,让人莫名其妙。
  • 作者会提出一些规则之外的特例,常常还自相矛盾。

一个女程序员职场自述:彻骨的孤独
美国《赫芬顿邮报》网站刚刚登载了一名女程序员的文章。该文章讲述了她作为女程序员在职场生活中所感受到的孤独,并分析了这种孤独感产生的五大原因。下面是这篇文章的全部内容:
我爱编程!我是在几年前才发现自己热爱编程的。以前,我只知道编程的技巧。后来,我发现编程可以让你创造新的东西,甚至帮助你周围的人。例如,我就帮助我的父母建了一个网站,帮助他们在网上做生意。现在,我可以明确地说,我热爱编程。我甚..

要想写出好的代码,你一定要牢记以下内容


可读性——不只是你,还有你身边与你合作的其他开发者

可维护性——让你的代码在修改的时候很简单

简洁性——不要让你的代码看上去毫无必要的复杂

效率性——尽可能的让你的代码获得最快的运行速度

明确性——如果你的代码能够做到不解自明,在大多数时候,你根本无需为其配备说明文档。在为方法和属性命名的时候,做到尽可能的合理。把长的代码进行拆分。不要复制/粘贴代码块。

如果你的同事不能轻松的看懂你写的代码,那么你的代码就不够好。

如果你想写好代码,那么你应当记住

  • 可读性 —— 对你与所有读你代码的人。
  • 可维护性 —— 保持你的代码易于修改。
  • 简单 —— 不要带来不必要的复杂性。
  • 高效 —— 你应让你的代码尽可能快。
  • 清晰 ——
    如果的你代码不解自明,那么大多数情况下并不需要注释。方法与属性的命名要说得通。把大段代码分割成小的模块。不要复制粘贴代码块。必要时要提供注释和文档,因为代码注释是源代码中唯一可以让人类直接阅读的文字,用于解释为什么某一段代码存在。

9月21日 08:25IT程序狮(14次阅读/2次分享/1次评论/3次点赞)

代码质量测试 


=””>1.找一个从来没读过你的代码的开发者,让他看你的代码,并且让他试着说出每一个模块的作用。 

=””>2.如果你经常需要向他进行解释,那么说明你的代码不够好。解释的次数越多,代码的质量就越低。 

=””>3.如果你只是静静的坐在一边,他无需问你任何问题,那说明你的代码质量很高。 

代码质量测试

  • 找一个从没看过你的代码的同伙读一遍并向你解释每一模块是干什么的。你越想插嘴解释几句,你的代码可能就越烂。如果你能很安静的闭嘴坐着,而你的同伙不需要问太多问题,那么你的代码很可能不错。

#前端技术#详见: 在本文中,作者分享了利用 CSS3
简单几步就可以实现的一些loading动画效果。前端er,来试试咯。[喵喵]

当你在写代码的时候,一些信号可以证明你写的代码质量不错:


  • 代码写的很聪明,但是又不会过分的聪明

  • 无论在速度上,还是可读性上,你都使用了最佳的算法

  • 类、变量和函数都得到了正确的命名,让人看一眼就能理解

  • 休息了一个周末之后,你继续写代码,发现自己可以立刻继续之前的工作

  • 那些需要重复使用的东西总是可用

  • 你所使用的方法都很短,最理想的情况下要少于50行,最多不超过100行而且能够完美的执行单个任务

  • 在调用方法的时候,你有着足够的信息,无需在代码堆中苦苦寻找

  • 能够很轻松的在此前的代码中进行功能添加和修改

  • try/catch块的体量尽可能的小

  • 毫不费力的就可以写出单元测试

好代码预兆

  • 写的代码挺聪明的,但没耍小聪明。
  • 算法在速度与可读性都是最优的。
  • 类、变量和函数的命名都说得通,不需要多余思考。
  • 一周不看这片代码后还能很快投入进入。
  • 该重用的都重用了,没重用的随时可以重用。
  • 方法都不长,都能单独完成一项任务。
  • 当你调用一个方法时不需要进去看代码。
  • 你的每个类都有一个单独的、清晰的职责(单一职责原则)。并与其它职责不同的类分离。
  • 你的方法都很简短,大多在50行以下,全部在100行以下,而且从名称可以清晰看出功能。
  • 当你需要回去修改项目功能时并不费劲,甚至很轻松。
  • 你的try/catch代码块很小。
  • 单元测试很好写。

9月21日 08:00前端大全(13次阅读/11次分享/7次评论/13次点赞)

好代码都是模块化的 


假设你的项目中有三个不同的层——内层、中层和外层。你的内容不应该从中层和外层那里导入任何东西。中层不应该从外层导入任何东西
,这样做的好处是,你可以对代码的内层进行独立测试。

“好的代码本身就是最好的说明文档。” — Steve McConnell


 原    文:Good code is its own best
documentation
 译    文:SDK.cn
 作    者:Christian(编译)

好代码是模块化的

假设你的项目中有三层:内层,中层和外层。那么内层不应该依赖中层和外层,而中层不应该依赖外层。这样,你的内层就可以被单独测试了。

在此再次奉上Bob大叔的Clean架构。

好代码是最好的文档。 —— SteveMcConnell

2 赞 4 收藏
评论

《探索 CSS3 中的 box-shadow
属性》box-shadow属性是一个CSS3属性,允许我们在几乎任何元素上来创建阴影效果,类似于在设计软件中的”drop
shadow”。阴影效果允许我们在原本平面的、二维的页面上面创建出深度的错觉。

9月21日 07:59稀土掘金(11次阅读/7次分享/3次评论/7次点赞)

javascript 高级编程 – Array 用法总结 – javascript
核心,数组相关方法的用法总结。原创by@程是非sky 详戳→

9月21日 12:06HTML5中国(10次阅读/4次分享/2次评论/4次点赞)

市面上现在流行两种沙箱模式,一种是使用iframe,还有一种是直接在页面上使用new
Function + eval进行执行. 殊途同归,主要还是防止一些Hacker们
吃饱了没事干,收别人钱来 Hack 你的网站. 一般情况,
我们的代码量有60%业务+40%安全. 剩下的就…

9月21日 10:41HTML5中国(8次阅读/5次分享/1次评论/4次点赞)

Spring的AOP特性又是如何利用这些基础的骨骼架构来工作的?Spring中又使用了那些设计模式来完成它的这种设计的?它的这种
设计理念对对我们以后的软件设计有何启示?

9月21日 09:41HTML5中国(8次阅读/5次分享/3次评论/4次点赞)

Spring作为现在最优秀的框架之一,已被广泛的使用,51CTO也曾经针对Spring框架中的JDBC应用做过报道。本文将从另外一个视角试图剖析出Spring框架的作者设计Spring框架的骨骼架构的设计理念,有那几个核心组件

9月21日 16:15IT程序狮(7次阅读/1次分享/1次评论/1次点赞)

#IT技术分享#详见:App网络基础知识概括 网络模块是 App
应用最基础最核心的模块, 稳定高效的网络处理是良好用户体验的基本保障。
本文将介绍日常开发中常用的网络协议以及使用方法。

9月21日 12:30程序员俱乐部(7次阅读/9次分享/4次评论/8次点赞)

对码农而言什么样的代码才能叫做好代码?
好的代码,就像是好的笑话——无需解释就能让别人明白。如果你的代码能够做到不解自明,在大多数时候,你根本无需为其配备说明文档。
好的代码,就像是一辆配备了优秀音响和杯架的汽车,这辆车在行驶到最高速度的时候,你听不到噪音,也不用担心水会洒出来。在它出现故障的时候,任何一名修理工都可以使用最常见的工具,在最短的时间里轻松将其修好。
而坏的代码,就像是一辆向你承诺最高速度可以达到200MPH,但是音响只能播放老式的磁带,而且杯架还不稳的车。..

9月21日 09:01稀土掘金(7次阅读/8次分享/7次评论/7次点赞)

推看——Android 开源 app –
「推看」是一款集知乎头条,美图,视频于一体的休闲阅读
app。作为练手项目,使用了 mvp 架构,引入 ButterKnife、Retrofit、Picasso
等开源库,实践 MaterialDesign,RxJava,界面上追求简洁优雅。分享by
小新丶很红 详戳→

9月21日 10:58IT程序狮(6次阅读/1次分享/1次评论/4次点赞)

#Java开发#详见:
观察者模式也叫做发布订阅模式,是一种行为型设计模式。在本文里,作者将通过观察者模式定义、使用场景、通用UML类图、使用实例为大家全面介绍Java设计模式之观察者模式。[威武]

9月21日 12:42HTML5中国(6次阅读/18次分享/7次评论/3次点赞)

在学习自定验证时,需要在页面上进行调试运行结果,这时的JS会影响运行结果的显示,所以我们会将JS代码屏蔽掉,那么我们该如何做呢?

9月21日 07:40稀土掘金(6次阅读/2次分享/1次评论/3次点赞)

基于 D3.js 的散点图和气泡图的实现 – 在之前的《基于 D3.js
的柱状图的实现》和《基于 D3.js
的折线图的实现》中,已经介绍过柱状图和折线图了。今天来说说非常相似的两种图表——散点图和气泡图。原创by
xgfe 详戳→

9月21日 08:41HTML5中国(5次阅读/6次分享/1次评论/10次点赞)

人工智能的一小步,人类的一大步,先从对付网络上的暴力或侮辱性言论开始吧。

9月21日 12:00前端开发博客(5次阅读/12次分享/9次评论/10次点赞)

#CSS3#在移动前端制作中,很多新的CSS3特性能够帮助我们更好的制作。例如这个垂直水平居中问题,就有一个简单的代码可以解决:利用CSS3的translate
#前端开发博客#

9月21日 08:00前端开发博客(4次阅读/15次分享/8次评论/15次点赞)

#CSS3#一般人不会说出来的移动前端动画技巧,文章来自“TQ的独立博客:玩转HTML5移动页面”,在这篇教程你会发现许多非常有用的动画处理技巧,细心点还会发现许多有用的zepto插件,例如…请戳→
#前端开发博客#

9月21日 19:24SegmentFault(4次阅读/13次分享/9次评论/16次点赞)

功能很简单,点击按钮后就可以对当前网页的模块进行选择隐藏,比如小广告,文章传送门:这次的练习是做一个Chrome的扩展,分享一下入门开发过程。因为在消息传递那块纠结了特别久,所以我会重点总结消息传递那块。
{代码…} 配置文件
每一个扩展都有一个JSON格式的manifest文件,叫manifest.json。 …

9月21日 20:19稀土掘金(4次阅读/17次分享/3次评论/10次点赞)

是如何工作的? – 讲解 工作原理的精悍小文,非常不错。原创by@天天读书计划
详戳→

9月21日 15:15SegmentFault(4次阅读/5次分享/1次评论/5次点赞)

喵呜~两种把图片裁切成菱形的方法,一种是基于元素嵌套方案,另外一种是裁切路径方案,传送门:菱形图片
在网页设计中,把图片裁切成菱形主要有两种方法。一种是基于元素嵌套方案,另外一种是裁切路径方案
元素嵌套方案 在线编辑
将图片用一个div包裹起来,对这个div变形,然后对图片应用相…

发表评论

电子邮件地址不会被公开。 必填项已用*标注

网站地图xml地图