目录

  • 一、引言
  • 二、书籍简介
  • 三、好代码自己会说话
    • 1. 清晰的变量命名规范
    • 2. 好注释与坏注释
    • 3. 错误处理
  • 四、总结

一、引言

你好,我是小雨青年,一名程序员。

今天为你推荐的书籍是《代码整洁之道》。

本书将为你解答:

  • 如何给变量命名;
  • 如何在代码中做错误处理;
  • 如何构建一个系统;
  • 如何做并发编程。

二、书籍简介

书名 代码整洁之道
作者 [美]Robert C.Martin
出版社 人民邮电出版社
ISBN 9787115216878

三、好代码自己会说话

1. 清晰的变量命名规范

本书给我的第一个收获就是,他可以把命名这件事整理得如此清晰!不管你从业多少年,给变量、函数、类命名的问题会一直陪着你,而这本书,给我们一个清晰的答案。

应当避免使用与本意相悖的词

包含List、import、java等类名、关键字或特殊字;字母o与数字0,字母l与数字1等。

使用可搜索的名称

一些常量,最好不直接使用数字,而指定一个变量名,这个变量名可以便于搜索到。比如:找MAX_CLASSES_PER_STUDENT很容易,但想找数字7就麻烦了。
长名称胜于短名称,搜得到的名称胜于用自造编码代写就的名称。

2. 好注释与坏注释

注释的恰当用法弥补我们在代码中的不足,因为代码一直在变动,所以注释会撒谎。

作者用了一整章的内容阐述,什么是好注释,什么是坏注释。

警示——用于警告其他程序员会出现某种后果的注释也是有用的。

//执行这个测试用例会导致小雨青年的配置文件失效。

多余的注释——简单函数的头部注释是多余的,读这段注释的时间没准儿比读这段代码都长。

废话注释——可能是复制粘贴后没有更改?

/** name */
private String name;/** name */
private String xiaoyuqingnian;

3. 错误处理

许多程序完全由错误处理占据,虽然错误处理很重要,但是如果它搞乱了代码逻辑,本身就是错误的做法。

别传递 null 值——大多数编程语言中,没有良好的方法能对付由调用者意外传入的 null 值。事已如此,恰当的做法就是禁止传入 null 值。

定义常规流程——在业务逻辑和错误处理代码之间有良好的区别,大量代码就会开始变得像是整洁而简朴的算法。

四、总结

本书应该也可以打上常看常新的标签了,哈哈。

推荐人群:工作经验3年以内的程序员

推荐理由:整洁的代码是程序员的基本功

【好书推荐】你想要的编码规范都在这里 | 《代码整洁之道》相关推荐

  1. 团队项目开发“编码规范”之九:代码分析

    团队项目开发"编码规范"之九: 代码分析 发布日期:2011年3月17日星期三作者:EricHu                                           ...

  2. Python好书推荐《Python代码整洁之道》——编写优雅的代码

    前言 Python是当今最流行的语言之一.相对较新的领域如数据科学.人工智能.机器人和数据分析,以及传统的专业如Web开发和科学研究等,都在拥抱Python.随着时间的推移,Python有可能会发展成 ...

  3. 代码整洁之道--命名规范

    给代码命名真的是一件很头疼的事情,对于命名规则,有一些基础的编码者,都会知道使用驼峰命名,比如userName,designPattern这样的驼峰命名法,这很酷,还有命名的时候不要使用什么int a ...

  4. 中科方德java开发编码规范_插件推荐:如何将Java编码规范落地实际开发中

    一个软件需要花费80%的生命周期成本去维护. 几乎没有任何软件的整个生命周期仅由其原作者来维护. 编码规范改善软件的可读性,让工程师更快更彻底地理解新的代码. 如果你将源代码转变为一个产品,那么您需要 ...

  5. Javascript编码规范,好的代码从书写规范开始,增强代码的可读性,可维护性,这是相当重要的!...

    1. 前言 JavaScript在百度一直有着广泛的应用,特别是在浏览器端的行为管理.本文档的目标是使JavaScript代码风格保持一致,容易被理解和被维护. 虽然本文档是针对JavaScript设 ...

  6. 3大利器推荐,帮你写出规范漂亮的python代码

    作者 | 奔跑的鳄鱼 来源 | 菜鸟学Python Python学了好久,但是拿出来review的代码好像总是长的不够俊美,不够工整!因此标准化的代码规范就显得尤为重要.今天就来推荐3个利器,pyth ...

  7. VC++, VC#, VB.NET 编码规范 (微软一站式示例代码库)

    vb.net教程https://www.xin3721.com/eschool/vbnetxin3721/ 经过三个月的不懈努力和反复检查,我们项目组终于完成了一份80页的VC++, VC#, VB. ...

  8. 《C++代码整洁之道》-C++代码整洁的基本规范

    在本章中,将介绍C++代码整洁的一些基础知识,这些通常是通用的知识,但是有些却是编程语言所特有的.例如,在所有编程语言中,起一个好名字是必不可少的.其他几个方面,如const的正确使用,智能指针的使用 ...

  9. 代码整洁之道 垃圾编码收集

    代码整洁之道 pdf扫描版 http://www.kuaipan.com.cn/file/id_6312425104087237.htm doc文字版 http://www.kuaipan.cn/fi ...

最新文章

  1. 【翻译】Apache Hbase新特性--MOB支持(一)
  2. 画原型前需要思考的一些事(上)
  3. DC-DC电源PCB设计指南
  4. Session一致性的解决方案
  5. Easy h-index
  6. Linux 给用户添加sudo权限
  7. mysql goldengate_oracle GoldenGate实现Oracle到MySQL数据平滑迁移
  8. 分享一本Swift好书
  9. ionic ios查看大图报错 the file to show is not valid image,or could not be loaded
  10. 计算机云客户端技术指标,云服务器技术指标
  11. 遥感数字图像处理 初体验
  12. Vensim模拟结果vdf数据文件转化为可读文本文件
  13. 下行文格式图片_下行文标准模版[2]
  14. RHEL 7 使用 CentOS 源安装 docker ce
  15. cgcs2000大地坐标系地图_2000国家大地坐标系
  16. hive Unexpected column vector type LIST
  17. Inductive Matrix Completion Based on Graph Neural Networks
  18. 史上最全的自动驾驶研究报告(下)
  19. stlink故障修复
  20. 2022android自定义文本路径选择器java教程

热门文章

  1. OTP(eFuse and Anti-Fuse)
  2. python环境变量配置(win10+Python27)
  3. [附源码]JAVA毕业设计医院病历管理系统(系统+LW)
  4. 计算机技术在农业上应用,计算机技术在农业科研中的应用
  5. linux系统安全与防护课时,Linux系统安全与防护基本操作
  6. 编写Java程序,用于显示人的姓名和年龄
  7. Vue + Element 实现请求加载数据时显示动效( Loading 加载 )
  8. ztree 自定义节点属性
  9. 你知道Java中的JCP, JEP, JLS, JSR是什么意思吗?
  10. 基于稀疏贝叶斯网络的情绪脑电的有效性 脑网络研究--论文总结