如何写出好代码
如何写出好代码
这个题目把我自己都看傻了,因为仔细想想,这不是一个命题,是对代码的思考,对细节的推敲和打磨。写好代码是一门学问,还是一种修行。 以前是公众号(JackieZheng)和博客同步更新,尤其是技术类文章。但是最近在公众号上写的比较多,因为在那我可以想写多少写多少,随时随地记录下自己的心得,还有勉励自己的鸡汤或是毒鸡汤。 以后应该会阶段性把公众号的文章总结出来,写成一篇博客,想了想,这样比较符合这两个平台的特性。
函数
函数贵在短小。
- 当你读代码,看到一个方法,如果长到需要滚动鼠标来往下翻后续内容,再碰上没有区块或方法层注释的,就要抓狂了。这时候短小的优势就出来了,通过区区几行就能很好诠释你的函数干了什么事岂不是皆大欢喜。
如果能通过阅读方法名就知道这个方法是干什么的最好了。比如现在有方法叫做
getData(...)
,还有一个叫做getPersonByName(...)
,显然后者强势碾压前者,起码我是这么认为的。这么写还有一个附加好处,就是省去了注释,因为方法名就是注释。 函数的目的就是为了告诉你它干了什么事,准确的说,它干了具体哪一件事。在设计模式的指导思想里面是有单一职责原则,对于函数也是一样。别指望一个函数能把所有的活都包了,那样大家都很累。比如
public PersonResult doSomething(String name, boolean isMarked, Person person) {
String[] names = name.split(",");
for(String name : names) {
//do some convert or others operations
}
if(isMarked) {
PersonResult personResult = new PersonResult();
personResult.setAge(person.getAget());
// ...
}
return personResult;
}
例子是刚刚想的,当然你可以写一个很长的全能doSomething
函数,但是读的人真的累。如果可以的话,这样是不是更好点
稍稍对比下,短小真的不是坏事,它能保持函数的内容在同一抽象层上,看着也舒服。
- 同一抽象层。这个概念很有意思,请教了老大有了比较好的理解。比如
public double getTotalSalaray() {
double baseSalaray = getBaseSalary();
//...
double salaryPart1 = 100;
double salaryPart2 = 200;
double salaryPart3 = 300;
double performanceSalary = salaryPart1 + salaryPart2 + ... + salaryPartN;N
return baseSalary + performanceSalary;
}
这个函数很单纯,真的只做了一件事,就是得到工资总额,包括基本工资和绩效工资。当我们看完第一行代码的时候,我们觉得赏心悦目,很好理解,如果你比较关系基本工资的细节,大可进入getBaseSalary()
方面里面一看究竟,可是在后面的绩效工资部分,就显得有些画风不对,我们不需要着这样的细节处理,我们更渴望与获取基本工资一样的抽象即可,好比这样
public double getTotalSalaray() {
double baseSalaray = getBaseSalary();
//...
double performanceSalaray = getPerformanceSalary();
return baseSalary + performanceSalary;
}
注释
有多少码农曾经一直被告诫要多些注释,写好注释,起码我之前是这样的被叮嘱的。但是看完《代码整洁之道》,发现注释不是什么好东西,起码没有我们想的那么好。
- 注释的副作用 谁也没法保证能一气呵成写完代码,而且永远不会有变动,所以我们需要经常变动代码,但是绝大多数时候,我们却由于各种原因忽视了变动注释。时间久了,代码和注释就不配套了,容易产生误解读。 在写下详细代码之后,又开始为这块代码加上注释,但是或许因为脑瓜子缺氧或是开小差了,写的注释与代码表达的逻辑不符,这样会让读者抓耳挠腮,匪夷所思。比如
public void getData(boolean isAdmin) {
// if isAdmin is true, get isGroup, if isGroup is true then doSomething
if(!isAdmin) {
boolean isGroup = PermissionUtil.getIsGroup();
if(isGroup) {
...
}
}
}
因为有很多判断,相信你应该会看一眼注释来帮助自己更好的理解这段代码,但是仔细一推敲,发现代码中的逻辑应该是isAdmin
为false
的时候,才会去获取isGroup
的值,而非像注释中提到为true
的时候。
- 有时候我们需要注释 必要的Javadoc,好比
/**
*get Person entity by id
*/
...
帮助澄清信息,比如
//example: www.test.childtest.com/v5/666
...domain + childDomain + version + id...
警示信息,对于一些代码的使用有些特殊场景要求,可以通过注释标示出来。 TODO 这个大家应该会经常使用吧,用来标记一些我们即将要实现的功能或者带扩展的功能。
- 我的技术投资策略:如何决定学习哪一个新技术的?
- Android6.0源码之蓝牙研究汇总(一)--from初学者
- Android6.0蓝牙协议之OPP
- 简单直白教你理解Java中四大引用强引用,软引用,弱引用,虚引用
- ubuntu系统上配置git
- Android源码编译出错No rule to make...
- Android中资源各种引用方式?,@,@*等等
- git撤销修改各种情况
- Android中ContentProvider简介
- 利用Androidstudio开发Java工程图文详解
- 小程序学习笔记分享(含1-tabBar、轮播图和九宫格)
- Android中ViewStub控件分析及使用
- 如何实现微信小程序的滚动加载功能
- 分享微信小程序推送消息步骤
- JavaScript 教程
- JavaScript 编辑工具
- JavaScript 与HTML
- JavaScript 与Java
- JavaScript 数据结构
- JavaScript 基本数据类型
- JavaScript 特殊数据类型
- JavaScript 运算符
- JavaScript typeof 运算符
- JavaScript 表达式
- JavaScript 类型转换
- JavaScript 基本语法
- JavaScript 注释
- Javascript 基本处理流程
- Javascript 选择结构
- Javascript if 语句
- Javascript if 语句的嵌套
- Javascript switch 语句
- Javascript 循环结构
- Javascript 循环结构实例
- Javascript 跳转语句
- Javascript 控制语句总结
- Javascript 函数介绍
- Javascript 函数的定义
- Javascript 函数调用
- Javascript 几种特殊的函数
- JavaScript 内置函数简介
- Javascript eval() 函数
- Javascript isFinite() 函数
- Javascript isNaN() 函数
- parseInt() 与 parseFloat()
- escape() 与 unescape()
- Javascript 字符串介绍
- Javascript length属性
- javascript 字符串函数
- Javascript 日期对象简介
- Javascript 日期对象用途
- Date 对象属性和方法
- Javascript 数组是什么
- Javascript 创建数组
- Javascript 数组赋值与取值
- Javascript 数组属性和方法