java 代码整洁快捷方式_代码整洁之道：你的代码是否足够优雅、整洁、易懂？...

普通的工程师堆砌代码，优秀的工程师优雅代码，卓越的工程师简化代码。如何写出优雅整洁易懂的代码是一门学问，也是软件工程实践里重要的一环。下面从注释、命名、方法，并发等视角简单给出了部分最佳实践。相信每一个优秀的工程师都有一颗追求卓越代码的心。

注释

不要给不好的名字加注释，一个好的名字比好的注释更重要

不要“拐杖注释”，好代码 > 坏代码 + 好注释

在文件/类级别使用全局注释来解释所有部分如何工作

一定要给常量加注释

团队统一定义标记

TODO 待处理的问题

FIXME 已知有问题的代码

HACK 不得不采用的粗糙的解决方案

命名

尽可能使用标准命名方法，比如设计模式，通用学术名词等

命名要找更有表现力的词

使用更专业的词，比如不用get而使用fetch或者download

避免空泛的名字，像tmp

使用具体的名字来细致的描述事物

给变量名带上重要的细节，比如加上单位ms等

为作用域大的名字采用更长的名字，作用域小的使用短名字

变量类型为布尔值表达加上is，has，can，should这样的词会更明确

方法

函数不应该有100行那么长，20行封顶最好

if else while等控制语句其中代码块应该只有一行，也就是一个函数调用语句

函数的锁进层次不应该多于两层

一个函数只做一件事，一个函数不应该能抽象出另外一个函数

某个公共函数调用的私有函数紧随其后

最理想的参数是零参数，最长不要超过三个入参，尽量不要输出参数

如果函数传入三个及以上参数最好将其抽象为类

标识参数十分丑陋，向函数传入布尔值用于区分不同业务的做法很丑陋，应该拆分为多个函数

异常与错误

抽离try catch包含的代码块，其中代码块抽象为一个函数

抛出的每个异常，都应当提供足够的环境说明，已便判断错误的来源与处所

不要将系统错误归咎于偶然事件

并发

分离并发相关代码与其它代码

严格限制对可能被共享的数据的访问

避免使用一个共享对象的多个同步方法

保持同步区域微小，尽可能少设计临界区

一起来讨论下：

1、在代码整洁工程实践上你有哪些好的建议？

2、数百人协作开发的代码如何保证代码整洁一致性？

3、你的代码属于哪一种境界？是否会去追寻代码整洁之道？

java 代码整洁快捷方式_代码整洁之道：你的代码是否足够优雅、整洁、易懂？...相关推荐

python代码写名字_必知必会系列_python代码优雅之道之代码命名约定
代码的命名约定对代码的提高可读性影响巨大.本文中,我们将总结并向您提供一些关于命名的最佳实践的示例,以帮助您编写更优雅的Python代码,使将来可能阅读和使用您的代码的人(包括您自己)受益. Pyth ...
java循环购物车结算系统_原生JS实现购物车结算功能代码
html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD ...
java数位倒置递归_有人能解释一下这个递归代码如何在java中反转int吗?
r根本不用 10*r+n%10 实际上,这是一件很棘手的事情,而且很酷. 这是一个很好的例子,说明变量命名不当会使代码难以理解.我们有3行代码可以实际执行某些操作,但它的工作原理并不明显. priva ...
我的世界java版地牢种子_我的世界pe地牢种子代码是什么
今天小编为大家解析一下我的世界pe地牢种子代码是什么,想玩种子代码的地形的玩家别错过下面的内容! 我的世界手游地牢怎么找地牢一般周围是由圆石和苔石组成的一个方形火柴盒里面会有一个刷怪笼(僵尸或者骷 ...
Java实现抓娃娃_简易抓娃娃机H5的代码实现
本文的实现主要用PixiJs实现.PixiJS是比较著名的2D渲染引擎.可以参照教程做事前学习了解. 准备工作第一步是图片资源.这些都是从现有的抓娃娃h5中找到的一些png资源.具体可以查看资源目录 ...
春夏秋冬java用代码怎么写_春夏秋冬季节判断（C语言代码）
解题思路: 注意事项: 参考代码: #include int main() { int a; scanf("%d",&a); switch(a) { case 1:prin ...
java表白程序玫瑰花_给爱人的玫瑰花表白程序代码--Java版
1 书写表白语句的frame(渐入功能) package com.wanju.blessing; import java.awt.Color; import java.awt.Container; i ...
java接口汽车品牌_根据品牌获取所有车型示例代码
package api.jisuapi.car; import api.util.HttpUtil; import net.sf.json.JSONArray; import net.sf.json. ...
代码合并工具_分享几款比较常用的代码比较工具
俗话说:三句不离本行,对于程序员这个可爱的群体来说也是一样,即使面对无休无止的编程工作,程序员们依旧任劳任怨的埋头苦干,梦想着用自己码下的代码改变世界.工欲善其事,必先利其器,每一位程序员都有自己私藏 ...

java 代码整洁快捷方式_代码整洁之道：你的代码是否足够优雅、整洁、易懂？...

java 代码整洁快捷方式_代码整洁之道：你的代码是否足够优雅、整洁、易懂？...相关推荐

最新文章

热门文章