1.根本----良好端正的态度。

2.命名----有意义,规范,可搜索的名称,使用源自问题领域的名称,至少避免误导。

3.类名----名词或者名词短语。

4.方法----应当是动词或者动词短语。

5.双关----最好不要用这种,谁知道add是添加还是相加呢?

6.函数----要短小,印象最深的就是,一个函数只做一件事儿,即使我们需要用到try -catch,也要再独立成一个方法,并且这个方法的第一个单词应该是try。

7.注释----代码即注释当然是最高境界,当我们想写注释才能更好的表达程序的时候,想想有没有更好的修改办法。如果必须注释,那么注释必须要。

简洁,并且注释同样需要维护,也许随着代码的演变,旧的注释就变得没有意义了。

---------------------------以上内容有待后续追加---------------------------------------------

反例:我所见到的让人厌恶的代码,引以为戒

1.处理相似的逻辑和功能时,完全复制代码,毫无个人思想,甚至方法,对象,变量命名都不做修改,更甚至复制来的注释也不修改。

2.一个方法几十行甚至更多--一个屏幕装不下,就拿一段jq异步代码来说吧,异步是一件事儿,获取异步需要传递的参数是一件事,异步中的success或者error的回调实现又是一件事儿,回调方法里的更多的操作还是一件事儿,种种事情一行行写下来,还能看?

3.某些自认为大牛的人实现某些复杂的功能需求,并不感兴趣完善某些校验和细节工作,留给实习生们,然而整洁度并不让人恭维。引起的问题一是其他人修改起来并不方便,二是其让人在为你完善细节的时候,还要重新读一遍两遍代码,我想这样并不会提高工作效率吧。

4.一个七八个参数的方法,要求传递的参数并没有留下注释?不光是修改的时候很困难,在调用方法的时候,也让人一头雾水。

5.某个业务基本不需要处理逻辑,能把为了方便,直接在逻辑层操作数据库?不可思议!

6.在使用aspx时,cs文件一行代码都没有,为了项目整体的漂亮,却要坚持使用aspx?这样真的漂亮?

7.几十甚至上百个页面,放在相同的文件夹下更好还是稍微分下类好呢!

8.一个负责增删改查的ashx,能命名为addadmin?  我们ManageAdmin不好吗

-------15.07.29新增

9.个人反对不同的命名空间或者程序集下下使用相同的类名,DAL层和BLL层都有一个User.cs 这样虽然不会有什么问题,但是用UserService和UserDal不更好吗

读《代码整洁之道》前四章浅显印象 和 我所见的不整洁代码引以为戒相关推荐

  1. 敏捷整洁之道 -- 第一章 介绍敏捷

    敏捷整洁之道 -- 第一章 介绍敏捷 1. 敏捷的历史 2. 敏捷中心思想 3. 敏捷全貌 3.1 铁十字 3.2 墙上的图 3.3 需要知道的第一件事 3.4 分析.设计.实施阶段 3.5 敏捷项目 ...

  2. 代码整洁之道(RobertC.Martin)之第二章: 变量

    一.前言 本段为第二章大体内容解释.本篇均取自代码整洁之道, 有兴趣的可以留言或私信我. 二.十四条经典简洁概念 //对整洁之道第二章有删减,取出了其中我们常常需要用到的简洁方法 名副其实 => ...

  3. 代码整洁之道 - 读感

    最近翻看了下代码整洁之道这本书,下面简单说下这本书都写了些啥,要告诉我们哪些东西. 能学到些什么? 阅读<代码整洁之道>需要你做些什么呢?你将阅读代码--大量代码.<代码整洁之道 ...

  4. 《代码整洁之道 Clean Architecture》-读书笔记

    大家好,我是烤鸭: 关于<代码整洁之道>,记录一下读书笔记. 代码整洁之道 第一章 整洁代码 整洁代码的艺术 第二章 有意义的命名 避免误导 有意义的区分 使用读得出来和可搜索的名字 避免 ...

  5. 《代码整洁之道》目录—导读

    版权声明 代码整洁之道 Authorized translation from the English language edition, entitled Clean Code: A Handboo ...

  6. 《代码整洁之道》读书笔记✍ 教你写 clean code

    代码整洁之道 第一章 整洁代码 1.1 什么是整洁的代码? 资深程序员告诉你什么是整洁的代码,下面详细介绍了Bjarne Stroustrup的描述,其他描述就不一一列出了,在此只记录几个关键点. 我 ...

  7. 【苦练基本功】代码整洁之道 pt1(第1章-第3章)

    代码整洁之道 pt1(第1章-第3章) 1 整洁代码 1.1 要有代码 1.2 糟糕的代码 1.3 混乱的代价 1.3.1 什么是整洁代码? 2 有意义的命名 2.1 名副其实 2.2 避免误导 2. ...

  8. 【苦练基本功】代码整洁之道 pt4(第10章-第12章)

    代码整洁之道 pt4(第10章-第12章) 10 类 10.1 类的组织 10.2 类应该短小 10.2.1 单一权责原则 10.2.2 内聚 10.2.3 保持内聚性就会得到许多短小的类 10.3 ...

  9. 【苦练基本功】代码整洁之道 pt3(第7章-第9章)

    代码整洁之道 pt3(第7章-第9章) 7 错误处理 7.1 使用异常而非返回码 7.2 先写try-catch-finally 7.3 使用未检异常 7.4 给出异常发生的环境说明 7.5 依调用者 ...

最新文章

  1. 使用WinHttp接口实现HTTP协议Get、Post和文件上传功能
  2. c 清除 html标签,13.4. 去除HTML的标签tag:htmlRemoveTag
  3. TP-GAN 侧脸修复
  4. 在一表中设置组合主键(两个字段组合成一个主键)
  5. matlab绘图大全
  6. if test 多条件_if函数进阶篇 嵌套+多条件判断
  7. FE助手 json格式化 reslet client
  8. Java面试题目,java工程师成神之路
  9. 学习和使用web标准的十大理由
  10. ofo 列入被执行人;摩拜 LV 跨界合作;iPhone X 遭黑客攻击 | 极客头条
  11. mfc 学习的第三天
  12. 计算机组成原理---之原码,补码,反码
  13. Dubbo源码解析-Dubbo架构的实现
  14. 获得当天的 零点 和 当天的最后 一秒的时刻
  15. 点播系统加服务器加投影加音响,打造真实家庭影院 投影机+音响巧搭配
  16. 基金定投如何选择买卖点?——关于定投的择时研究
  17. Pygame——AI重力四子棋
  18. 不断收集一些不错的博客(献给未来路上的人)
  19. js 判断一个 object 对象是否为空
  20. 嵌入式软件是怎么分类的?

热门文章

  1. java.net.SocketException:No buffer space avaliable(maximum connection reached?):JVM_Bind 解决办法...
  2. RabbitMQ(三) ——发布订阅
  3. 《DSP using MATLAB》示例Example7.20
  4. SVN本地代码未提交而被覆盖
  5. 利用MiddleGen-hibernate-r5生成hbm文件及POJO文件
  6. HDU 1850 Being a Good Boy in Spring Festival
  7. 如何防止插入删除表造成的数据库死锁
  8. C# override详解
  9. c++中 结构体和类的区别
  10. 微信小程序实现时间戳转为时间格式