Effective Kotlin中文版
  • ReadMe
  • 前言
  • 第一部分:良好的代码
    • 第一章:安全性
      • 第1条:限制可变性
      • 第2条:最小化变量的作用域
      • 第3条:尽可能消除平台类型
      • 第4条: 不要暴露需要推断的类型
      • 第5条:指明你期望的参数和状态
      • 第 6 条: 优先使用标准错误,而不是自定错误
      • 第7条:当返回结果可能缺失时,优先使 null 或 Failure
      • 第8条:妥善处理空值
      • 第9条: 使用 use 来关闭资源
      • 第10条:编写单元测试
    • 第二章:可读性
      • 第11条:为了可读性设计代码
      • 第12条:操作符的行为应该与其名称一致
      • 第13条:避免返回或操作 Unit?
      • 第14条: 在变量不清晰时指定其类型
      • 第15条:考虑显式引用接收者
      • 第16:属性应该代表状态,而非行为
      • 第17条:考虑使用具名参数
      • 第18条:遵守编程惯例
  • 第二部分:良好的设计
    • 第三章:可重用性
      • 第19条:不要重复知识
      • 第20条:不要重复实现常用算法
      • 第21条 使用属性代理来提取公共的属性模式
      • 第22条:当实现公共算法时使用泛型
      • 第23条:避免隐藏类型参数
      • 第24条:在使用泛型时考虑型变
      • 第25条:在不同的平台上提取公共模块进行重用
    • 第四章:抽象设计
      • 第26条:每个方法都应该基于单一的抽象级别而编写
      • 第27条:使用抽象来保护代码不受更改
      • 第28条:指定 Api 的稳定性
      • 第29条:考虑包装扩展 API
      • 第30条:最小化元素的可见性
      • 第31条:用文档定义合约
      • 第32条:遵守抽象合约
    • 第五章:对象的创建
      • 第33条:考虑使用工厂方法代替构造函数
      • 第34条:考虑带命名默认参数的主构造函数
      • 第35条:考虑为复杂的对象创建定义 DSL
    • 第六章:类的设计
      • 第36条:组合优于继承
      • 第37条:使用数据修饰符来表示一组数据
      • 第38条:使用函数类型而不是接口来传递操作和行为
      • 第39条:类层次结构优于标签类
      • 第40条:遵守 equals 的合约
      • 第41条:遵守 hashCode 的合约
      • 第42条:遵守 compareTo 的合约
      • 第43条: 考虑将 API 的非必要部分提取到扩展函数中
      • 第44条:避免在成员中定义扩展
  • 第三部分:性能
    • 第七章:让开发成本更低
      • 第45条:避免不必要的对象创建
      • 第46条:给高阶函数使用 inline 修饰符
      • 第47条:考虑使用内联类
      • 第48条:消除过时的对象引用
    • 第八章:高效的集合处理
      • 第49条:在具有多个处理步骤的大型集合上,优先使用 Sequence
      • 第50条:限制操作步骤的数量
      • 第51条:性能关键处考虑使用原语的数组
      • 第52条:考虑使用可变集合
Powered by GitBook
On this page
  1. 第一部分:良好的代码

第二章:可读性

Previous第10条:编写单元测试Next第11条:为了可读性设计代码

Last updated 2 years ago

任何傻瓜都能写出计算机能理解的代码,而优秀的程序能写出人能够理解的代码。

--- Martin Fowler 《重构: 改善既有的代码设计》P1

有一个非常普遍的误解,认为 Kotlin 的设计是简洁的,它其实不是,还有更简洁的语言,例如我所知最简洁的语言是 APL,下面代码是 John Conway 用 APL 实现的 “Game of Life”:

你的第一个想法可能会是:“哇,真短呀”,然后你可能会意识到你的键盘上没有这些字符。 有很多这样的语言,例如同样的程序在 J 语言是这样的:

life=:[:+/(3 4=/[:+/(,/,"0/~i:1)|.])*.1,:]

这两种语言都非常的简洁,这一特点使得它们成为代码高尔夫比赛的冠军。 这也让它们难以阅读,让我诚实地说:即使是对那些经验丰富的 APL 开发人员(这个世界上可能只有少数人)来说,理解这个程序在做什么和怎么做也是一个挑战。

Kotlin 从来没有想要非常简洁,它被设计成可读的,与其他流行语言相比,它是简洁的,但这是因为 Kotlin 消除了许多干扰:样板代码、重复的结构。 这样做是为了帮助开发人员专注于重要的事情,从而使 Kotlin 更具可读性。

Kotlin 允许程序员设计干净而有意义的代码和 api,它的功能可以让我们隐藏或凸显任何我们想要的东西。本章是讨论关于如何明智地使用这些工具,该章作为导论,并提供了一组通用建议,也将引入可读性的概念,我们也会在本书的其余部分中提到。特别是在第二部分:抽象的设计中,我们将深入类与函数设计的相关主题。\

让我们从一个关于可读性的更抽象的条目开始,它将引入一般的问题。