读《代码整洁之道》前四章浅显印象 和 我所见的不整洁代码引以为戒
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. 敏捷的历史 2. 敏捷中心思想 3. 敏捷全貌 3.1 铁十字 3.2 墙上的图 3.3 需要知道的第一件事 3.4 分析.设计.实施阶段 3.5 敏捷项目 ...
- 代码整洁之道(RobertC.Martin)之第二章: 变量
一.前言 本段为第二章大体内容解释.本篇均取自代码整洁之道, 有兴趣的可以留言或私信我. 二.十四条经典简洁概念 //对整洁之道第二章有删减,取出了其中我们常常需要用到的简洁方法 名副其实 => ...
- 代码整洁之道 - 读感
最近翻看了下代码整洁之道这本书,下面简单说下这本书都写了些啥,要告诉我们哪些东西. 能学到些什么? 阅读<代码整洁之道>需要你做些什么呢?你将阅读代码--大量代码.<代码整洁之道 ...
- 《代码整洁之道 Clean Architecture》-读书笔记
大家好,我是烤鸭: 关于<代码整洁之道>,记录一下读书笔记. 代码整洁之道 第一章 整洁代码 整洁代码的艺术 第二章 有意义的命名 避免误导 有意义的区分 使用读得出来和可搜索的名字 避免 ...
- 《代码整洁之道》目录—导读
版权声明 代码整洁之道 Authorized translation from the English language edition, entitled Clean Code: A Handboo ...
- 《代码整洁之道》读书笔记✍ 教你写 clean code
代码整洁之道 第一章 整洁代码 1.1 什么是整洁的代码? 资深程序员告诉你什么是整洁的代码,下面详细介绍了Bjarne Stroustrup的描述,其他描述就不一一列出了,在此只记录几个关键点. 我 ...
- 【苦练基本功】代码整洁之道 pt1(第1章-第3章)
代码整洁之道 pt1(第1章-第3章) 1 整洁代码 1.1 要有代码 1.2 糟糕的代码 1.3 混乱的代价 1.3.1 什么是整洁代码? 2 有意义的命名 2.1 名副其实 2.2 避免误导 2. ...
- 【苦练基本功】代码整洁之道 pt4(第10章-第12章)
代码整洁之道 pt4(第10章-第12章) 10 类 10.1 类的组织 10.2 类应该短小 10.2.1 单一权责原则 10.2.2 内聚 10.2.3 保持内聚性就会得到许多短小的类 10.3 ...
- 【苦练基本功】代码整洁之道 pt3(第7章-第9章)
代码整洁之道 pt3(第7章-第9章) 7 错误处理 7.1 使用异常而非返回码 7.2 先写try-catch-finally 7.3 使用未检异常 7.4 给出异常发生的环境说明 7.5 依调用者 ...
最新文章
- 使用WinHttp接口实现HTTP协议Get、Post和文件上传功能
- c 清除 html标签,13.4. 去除HTML的标签tag:htmlRemoveTag
- TP-GAN 侧脸修复
- 在一表中设置组合主键(两个字段组合成一个主键)
- matlab绘图大全
- if test 多条件_if函数进阶篇 嵌套+多条件判断
- FE助手 json格式化 reslet client
- Java面试题目,java工程师成神之路
- 学习和使用web标准的十大理由
- ofo 列入被执行人;摩拜 LV 跨界合作;iPhone X 遭黑客攻击 | 极客头条
- mfc 学习的第三天
- 计算机组成原理---之原码,补码,反码
- Dubbo源码解析-Dubbo架构的实现
- 获得当天的 零点 和 当天的最后 一秒的时刻
- 点播系统加服务器加投影加音响,打造真实家庭影院 投影机+音响巧搭配
- 基金定投如何选择买卖点?——关于定投的择时研究
- Pygame——AI重力四子棋
- 不断收集一些不错的博客(献给未来路上的人)
- js 判断一个 object 对象是否为空
- 嵌入式软件是怎么分类的?
热门文章
- java.net.SocketException:No buffer space avaliable(maximum connection reached?):JVM_Bind 解决办法...
- RabbitMQ(三) ——发布订阅
- 《DSP using MATLAB》示例Example7.20
- SVN本地代码未提交而被覆盖
- 利用MiddleGen-hibernate-r5生成hbm文件及POJO文件
- HDU 1850 Being a Good Boy in Spring Festival
- 如何防止插入删除表造成的数据库死锁
- C# override详解
- c++中 结构体和类的区别
- 微信小程序实现时间戳转为时间格式