当前位置:首页 > 软件开发 > 正文

代码整洁之道总结?代码整洁之道 英文版 百度网盘

代码整洁之道总结?代码整洁之道 英文版 百度网盘

其实代码整洁之道总结的问题并不复杂,但是又很多的朋友都不太了解代码整洁之道 英文版 百度网盘,因此呢,今天小编就来为大家分享代码整洁之道总结的一些知识,希望可以帮助到大...

其实代码整洁之道总结的问题并不复杂,但是又很多的朋友都不太了解代码整洁之道 英文版 百度网盘,因此呢,今天小编就来为大家分享代码整洁之道总结的一些知识,希望可以帮助到大家,下面我们一起来看看这个问题的分析吧!

有代码洁癖的人看到团队里随意写代码的人该怎么安慰自己

好问题!我自己有时候也会受到类似的困扰。

我感觉自己属于代码洁癖的那种。洁癖到什么程度呢?有时候一个变量的命名要思考好久,平时看到代码里的空格不规范啥的,总是想纠正过来。

例如:a=a+1,我总想纠正为a=a+1

有时确实会看到一些比较随意的代码。当然不都是同团队的,还有从别的团队接手过来要维护的程序。遇到一些奇怪的代码,也总是有想吐槽的心理。不过为什么要安慰自己呢?因为自己看着不爽吗,这个我觉得是自己心态的问题了,如果洁癖到了这种程度是要调整一下的。

至于怎么面对不规范的代码,有些建议供参考。

要明白不规范的代码属于哪种类型,有的属于可读性差,有的属于性能问题,有的属于扩展性差。

如果你和同事关系不错,可以试着沟通一下,把不规范的地方修改掉

对于可能对功能或性能有影响的问题,不要藏着掖着,务必要在上线前改掉,否则可能会留下后患

学会自省,现在不少程序员有个毛病。总觉得自己代码完美无缺,别人的代码就是一坨翔,这个很不可取。先看看自己有没有类似的毛病

如果同事不听劝,那也没关系。我们更重要的是提升自己的水平,这样长期看才有更强的竞争力。

代码规范是工程规范的一部分,对自身有追求的程序员不会放过对代码整洁的追求。推荐《代码整洁之道》这本书,学习学习前人的经验。给自己的未来打下扎实的基础。

如何写出简洁、高效的代码

给亲推荐一篇阿里巴巴高级开发工程师竹涧分享的关于代码整洁之道的一篇文,希望对你有所帮助。

Anyfoolcanwritecodethatacomputercanunderstand.Goodprogrammerswritecodethathumanscanunderstand.

普通的工程师堆砌代码,优秀的工程师优雅代码,卓越的工程师简化代码。如何写出优雅整洁易懂的代码是一门学问,也是软件工程实践里重要的一环。笔者推荐三本经典的书籍《代码整洁之道》、《编写可读代码的艺术》、《重构:改善既有代码的设计》,下文重点将从注释、命名、方法、异常、单元测试等多个方面总结了一些代码整洁最佳实践,大部分是笔者总结于以上三本书中的精华,也有部分是笔者工程实践的总结。篇幅有限,本文将总结性给出一些实践建议,后续会有文章来给出一些代码整洁之道的事例。

注释

不要给不好的名字加注释,一个好的名字比好的注释更重要不要“拐杖注释”,好代码>坏代码+好注释在文件/类级别使用全局注释来解释所有部分如何工作一定要给常量加注释团队统一定义标记TODO待处理的问题FIXME已知有问题的代码HACK不得不采用的粗糙的解决方案在注释中用精心挑选的输入输出例子进行说明注释应该声明代码的高层次意图,而非明显的细节不要在代码中加入代码的著作信息,git可以干的事情不要交给代码源代码中的html注释是一种厌物,增加阅读难度注释一定要描述离它最近的代码注释一定要与代码对应公共api需要添加注释,其它代码谨慎使用注释典型的烂注释不恰当的信息废弃的注释冗余注释糟糕的注释注释掉的代码唯一真正好的注释是你想办法不去写的注释不要有循规式注释,比如setter/getter注释不要添加日志式注释,比如修改时间等信息(git可以做的事情)注释一定是表达代码之外的东西,代码可以包含的内容,注释中一定不要出现如果有必要注释,请注释意图(why),而不要去注释实现(how),大家都会看代码适当添加警示注释

命名

尽可能使用标准命名方法,比如设计模式,通用学术名词等命名要找更有表现力的词使用更专业的词,比如不用get而使用fetch或者download避免空泛的名字,像tmp使用具体的名字来细致的描述事物给变量名带上重要的细节,比如加上单位ms等为作用域大的名字采用更长的名字,作用域小的使用短名字变量类型为布尔值表达加上is,has,can,should这样的词会更明确变量名称长短应该与其作用域对应别害怕长名称,长而具有描述性的名称比短而令人费解的名称好函数名称应该说明副作用,名称应该表达函数,变量或类的一切信息,请不要掩盖副作用,比如CreateAndReturnXXX

方法

函数不应该有100行那么长,20行封顶最好ifelsewhile等控制语句其中代码块应该只有一行,也就是一个函数调用语句函数的锁进层次不应该多于两层一个函数只做一件事,一个函数不应该能抽象出另外一个函数某个公共函数调用的私有函数紧随其后最理想的参数是零参数,最长不要超过三个入参,尽量不要输出参数如果函数传入三个及以上参数最好将其抽象为类标识参数十分丑陋,向函数传入布尔值用于区分不同业务的做法很丑陋,应该拆分为多个函数别返回null值,抛出异常或者返回特殊对象,尽量避免NPE别传入null值

异常与错误

抽离trycatch包含的代码块,其中代码块抽象为一个函数抛出的每个异常,都应当提供足够的环境说明,已便判断错误的来源与处所不要将系统错误归咎于偶然事件

并发

分离并发相关代码与其它代码严格限制对可能被共享的数据的访问避免使用一个共享对象的多个同步方法保持同步区域微小,尽可能少设计临界区

单元测试

不要怕单元测试的方法名字太长或者繁琐,测试函数的名称就像注释不要追求太高的测试覆盖率,测试代码前面90%通常比后面10%花的时间少使用最简单的并且能够完整运用代码的测试输入给测试函数取一个完整性的描述性名字,比如Test_测试代码与生产代码一样重要如果测试代码不能保证整洁,你就会很快失去他们每个测试一个断言,单个测试中断言数量应该最小化也就是一个断言FIRST原则快速Fast独立Independent测试应该相互独立可重复Repeatable测试应当在任何环境中重复通过自足验证Self-Validating测试应该有布尔值输出及时Timely最好的方式是TDD

代码结构

代码行长度控制在100-120个字符可能用大多数为200行,最长500行的单个文件构造出色的系统关系密切的代码应该相互靠近变量声明应该靠近其使用位置若某个函数调用了另外一个,应该把他们放在一起,而且调用者应该放在被调用者上面自上向下展示函数调用依赖顺序应该把解释条件意图的函数抽离出来,尽可能将条件表达为肯定形式不要继承常量,比如接口中定义常量,不要使用继承欺骗编程语言的作用范围规则模块不应了解它所操作对象的内部情况DTO(DataTransferObjects)是一个只有公共变量没有函数的类对象暴露行为,隐藏数据不要使用“尤达表示法”如if(null==obj),现代编译器对if(obj=null)这样的代码会给出警告一般情况使用ifelse,简单语句使用三目运算符通常来讲提早返回可以减少嵌套并让代码整洁

设计

类应该足够短小类应该满足单一权责原则(SRP),类和模块只有一个修改理由类应该只有少量的实体变量类应该遵循依赖倒置原则DIP(DependencyInversionPrinciple),类应该依赖于抽象而不是依赖于具体细节类中的方法越少越好,函数知道的变量越少越好,类拥有的实体变量越少越好通过减少变量的数量和让他们尽量“轻量级”来让代码更有可读性减少变量缩小变量的作用域只写一次的变量更好,如常量最好读的代码就是没有代码从项目中消除不必要的功能,不要过度设计从新考虑需求,解决版本最简单的问题,只要能完成工作就行经常性地通读标准库的整个API,保持对他们的熟悉程度简单设计运行所有测试不可重复表达了程序员的意图尽可能减少类和方法的数量以上规则按重要程度排列无论是设计系统或者单独模块,别忘了使用大概可工作的最简单方案整洁的代码只提供一种而非多种做一件事的途径,他只有尽量少的依赖。明确定义并提供尽量少的API减少重复代码,提高表达力,提早构建,简单抽象

小结

作为代码整洁之道系列的第一篇,本文从注释、命名、方法,单元测试,并发等视角简单给出了一些最佳实践,下文我们会展开来从每个方面介绍更多的实践事例。相信每一个优秀的工程师都有一颗追求卓越代码的心,在代码整洁工程实践上你有哪些好的建议?数百人协作开发的代码如何保证代码整洁一致性?欢迎大家来讨论。

如何写出优雅的Java代码

请仔细阅读,努力学习这几种程序设计方法。真的对java编程很有好处,希望可以背下来。

论面向组合子程序设计方法之创世纪

论面向组合子程序设计方法之失乐园之补充

论面向组合子程序设计方法之燃烧的荆棘

论面向组合子程序设计方法之新约

论面向组合子程序设计方法之oracle

论面向组合子程序设计方法之重构

论面向组合子程序设计方法之monad

论面向组合子程序设计方法之南无阿弥陀佛

论面向组合子程序设计方法之重构2

论面向组合子程序设计方法之微步毂纹生

熟读并背诵,每个月默写一次

如何高效的写代码呢

我觉得有以下基本原则需要注意:

1.熟习理解需要实现的算法

2.算法的思想

3.算法的框架和层次结构

4.算法的细节

5.一定要有测试框架来支持代码的开发过程,比如:

单元测试

集成测试

6.先实现框架,再逐步添加细节

7.设计简单的可验证程序正确性的数据例子

cs怎么旋转代码

在CS中旋转代码需要选中代码后按下CTRL+R进行旋转。这样做的原因是为了让代码更加美观整洁,同时也方便了运算符和操作数的排列。需要注意的是,旋转后的代码需要重新测试,以保证函数仍然能够正常工作。

好了,关于代码整洁之道总结和代码整洁之道 英文版 百度网盘的问题到这里结束啦,希望可以解决您的问题哈!

最新文章