美文网首页
代码整洁(学习笔记)

代码整洁(学习笔记)

作者: Ashley2333 | 来源:发表于2018-05-06 18:43 被阅读0次

软件开发中的 5S 原则:

  • 整理:命名的规范
  • 整顿:把你的代码放在它应该在的地方
  • 清楚:整洁代码
  • 清洁:代码风格、实践手段
  • 身美:不断改进

有意义的命名

  • 变量名、方法名:使用小驼峰法 --- 除第一个单词之外,其他单词首字母大写
eg:
var myStudents;
function getStudentById(){}
  • 类名:使用大驼峰法 --- 所有单词的首字母都大写
eg:
class BaseUser{}

好的命名遵循下列的规范:

  • 名副其实:不需要被注释也应该被理解、看懂。怎么用、做什么事、为什么存在
  • 避免误导:(I 、O),这到底是 I 还是 1,是 O 还是 0;(傻傻分不清)
  • 做有意义的区分:
    不要使用 a1、a2、a3
    不要说废话(student 就不要再写成 studentInfo 或者 studentData 了)
  • 使用读得出来的名称
  • 使用可搜索的名称:不要使用硬编码,尽量使用常量替代
  • 一致的命名规则:比如查找都用 find**
  • 不要使用双关语

明了的函数

  • 短小
  • 每一个函数/方法应该只干一件
  • 函数参数:
    一元参数:有输入应该也有输出
    二元参数:尽量不要使用,除非参数是有序组成的(new Point(x,y))
    如果参数个数超过两个,考虑下把参数封装一下在传过去
  • 别重复自己

注释

法律信息
提供信息的注释(时间格式...)
对意图的解释
警告
TODO
公共 API

相关文章

  • 代码整洁(学习笔记)

    软件开发中的 5S 原则: 整理:命名的规范 整顿:把你的代码放在它应该在的地方 清楚:整洁代码 清洁:代码风格、...

  • 代码整洁笔记

    代码千万条,清晰第一条,编码不规范,同事两行泪。本文为《代码整洁之道》读书笔记 一: 函数1.1 短小1.2 只做...

  • 《代码整洁之道》细节之中自有天地,整洁成就卓越代码 读书笔记

    《代码整洁之道》细节之中自有天地,整洁成就卓越代码 读书笔记 There are only two hard th...

  • 代码整洁之道学习笔记

    代码整洁之道读书笔记 一、有意义的命名 名副其实 表示产品A上线时间剩余天数 获取水果订单中所有的id为4的苹果订...

  • 代码整洁之道-<函数>

    代码整洁之道-<函数> 代码整洁之道 一书相关读书笔记,整洁的代码是自解释的,阅读代码应该如同阅读一篇优秀的文章,...

  • 代码整洁之道-<有意义的命名>

    代码整洁之道-<有意义的命名> 代码整洁之道 一书相关读书笔记,整洁的代码是自解释的,阅读代码应该如同阅读一篇优秀...

  • [代码整洁之道]-整洁代码

    前段时间,看了代码整洁之道,顺手做了些笔记,分享给大家,和大家一起探讨整洁代码之道。 1.1要有代码 代码是我们最...

  • 代码整洁之道 - 笔记

    Clean CodeA Handbook of Agile Software Craftsmanship[美] R...

  • 代码整洁之道【笔记】

    一、整洁代码 A.混乱的代价 1.有些团队在项目初期进展迅速,但有那么一两年的时间却慢去蜗行。对代码的每次修改都影...

  • 【笔记】代码整洁之道

    一、整洁的代码 整洁的代码从不隐藏设计者的意图,充满了干净利落的抽象和直截了当的控制语句。 读写的花费时间比例超过...

网友评论

      本文标题:代码整洁(学习笔记)

      本文链接:https://www.haomeiwen.com/subject/owwurftx.html