代码整洁之道(Robert C. Martin力作，韩磊献译)
作者:[美]Robert C. Martin 著
格式: pdf、txt、epub、azw3、mobi、docx
编辑推荐
作者Martin是软件工程领域的大师级人物，是《敏捷软件开发：原则、模式与实践》、《敏捷软件开发：原则、模式与实践(C#版)》、《极限编程实践》等国内引进的畅销书的作者，其中多本原著荣获美国《软件开发》第13届震憾（Jolt）大奖，Martin的敏捷系列书是软件工程界的杰出书籍。
《代码整洁之道》是他的又一力作
Martin在书中对代码具有革命性的解读
阐述了整洁代码的敏捷实践的方法
书中介绍规则均来自Martin多年的经验，拥有很高的借鉴价值
内容简介
软件质量，不但依赖于架构及项目管理，而且与代码质量紧密相关。这一点，无论是敏捷开发流派还是传统开发流派，都不得不承认。
本书提出一种观念：代码质量与其整洁度成正比。干净的代码，既在质量上较为可靠，也为后期维护、升级奠定了良好基础。作为编程领域的佼佼者，本书作者给出了一系列行之有效的整洁代码操作实践。这些实践在本书中体现为一条条规则(或称“启示”)，并辅以来自现实项目的正、反两面的范例。只要遵循这些规则，就能编写出干净的代码，从而有效提升代码质量。
本书阅读对象为一切有志于改善代码质量的程序员及技术经理。书中介绍的规则均来自作者多年的实践经验，涵盖从命名到重构的多个编程方面，虽为一“家”之言，然诚有可资借鉴的价值。
作者简介
Robert C. Martin，是软件工程领域的大师级人物，是《敏捷软件开发：原则、模式与实践》、《敏捷软件开发：原则、模式与实践(C#版)》（邮电）、《极限编程实践》（邮电）等国内引进的畅销书的作者，其中第一本原著荣获美国《软件开发》第13届震憾（Jolt）大奖，Martin的敏捷系列书是软件工程界的权威书籍。
韩磊，互联网产品与运营专家，技术书籍著译者。曾在全球著名的IT中文社区CSDN及《程序员》杂志任副总经理、总编辑等职。现居广州。译著有《梦断代码》和《C#编程风格》。与刘韧合著《网络媒体教程》，与戴飞合译《BeginningC#Objects中文版：概念到代码》。
目 录
目 录
第1章 整洁代码 1
1.1 要有代码 2
1.2 糟糕的代码 2
1.3 混乱的代价 3
1.3.1 华丽新设计 4
1.3.2 态度 4
1.3.3 迷题 5
1.3.4 整洁代码的艺术 5
1.3.5 什么是整洁代码 6
1.4 思想流派 10
1.5 我们是作者 11
1.6 童子军军规 12
1.7 前传与原则 12
1.8 小结 12
1.9 文献 13
第2章 有意义的命名 15
2.1 介绍 15
2.2 名副其实 16
2.3 避免误导 17
2.4 做有意义的区分 18
2.5 使用读得出来的名称 19
2.6 使用可搜索的名称 20
2.7 避免使用编码 21
2.7.1 匈牙利语标记法 21
2.7.2 成员前缀 21
2.7.3 接口和实现 22
2.8 避免思维映射 22
2.9 类名 23
2.10 方法名 23
2.11 别扮可爱 23
2.12 每个概念对应一个词 24
2.13 别用双关语 24
2.14 使用解决方案领域名称 25
2.15 使用源自所涉问题领域的名称 25
2.16 添加有意义的语境 25
2.17 不要添加没用的语境 27
2.18 最后的话 27
第3章 函数 29
3.1 短小 32
3.2 只做一件事 33
3.3 每个函数一个抽象层级 34
3.4 switch语句 35
3.5 使用描述性的名称 36
3.6 函数参数 37
3.6.1 一元函数的普遍形式 38
3.6.2 标识参数 38
3.6.3 二元函数 38
3.6.4 三元函数 39
3.6.5 参数对象 39
3.6.6 参数列表 40
3.6.7 动词与关键字 40
3.7 无副作用 40
3.8 分隔指令与询问 42
3.9 使用异常替代返回错误码 42
3.9.1 抽离Try/Catch代码块 43
3.9.2 错误处理就是一件事 44
3.9.3 Error.java依赖磁铁 44
3.10 别重复自己 44
3.11 结构化编程 45
3.12 如何写出这样的函数 45
3.13 小结 45
3.14 SetupTeardownIncluder程序 46
3.15 文献 48
第4章 注释 49
4.1 注释不能美化糟糕的代码 50
4.2 用代码来阐述 51
4.3 好注释 51
4.3.1 法律信息 51
4.3.2 提供信息的注释 51
4.3.3 对意图的解释 52
4.3.4 阐释 53
4.3.5 警示 53
4.3.6 TODO注释 54
4.3.7 放大 54
4.3.8 公共API中的Javadoc 55
4.4 坏注释 55
4.4.1 喃喃自语 55
4.4.2 多余的注释 56
4.4.3 误导性注释 58
4.4.4 循规式注释 58
4.4.5 日志式注释 59
4.4.6 废话注释 59
4.4.7 可怕的废话 61
4.4.8 能用函数或变量时就别用注释 62
4.4.9 位置标记 62
4.4.10 括号后面的注释 62
4.4.11 归属与署名 63
4.4.12 注释掉的代码 63
4.4.13 HTML注释 64
4.4.14 非本地信息 64
4.4.15 信息过多 65
4.4.16 不明显的联系 65
4.4.17 函数头 66
4.4.18 非公共代码中的Javadoc 66
4.4.19 范例 66
4.5 文献 69
第5章 格式 71
5.1 格式的目的 72
5.2 垂直格式 72
5.2.1 向报纸学习 73
5.2.2 概念间垂直方向上的区隔 73
5.2.3 垂直方向上的靠近 74
5.2.4 垂直距离 75
5.2.5 垂直顺序 79
5.3 横向格式 79
5.3.1 水平方向上的区隔与靠近 80
5.3.2 水平对齐 81
5.3.3 缩进 82
5.3.4 空范围 84
5.4 团队规则 84
5.5 鲍勃大叔的格式规则 85
第6章 对象和数据结构 87
6.1 数据抽象 87
6.2 数据、对象的反对称性 89
6.3 得墨忒耳律 91
6.3.1 火车失事 91
6.3.2 混杂 92
6.3.3 隐藏结构 92
6.4 数据传送对象 93
6.5 小结 94
6.6 文献 94
第7章 错误处理 95
7.1 使用异常而非返回码 96
7.2 先写Try-Catch-Finally语句 97
7.3 使用不可控异常 98
7.4 给出异常发生的环境说明 99
7.5 依调用者需要定义异常类 99
7.6 定义常规流程 100
7.7 别返回null值 101
7.8 别传递null值 102
7.9 小结 103
7.10 文献 104
第8章 边界 105
8.1 使用第三方代码 106
8.2 浏览和学习边界 107
8.3 学习log4j 108
8.4 学习性测试的好处不只是免费 110
8.5 使用尚不存在的代码 110
8.6 整洁的边界 111
8.7 文献 112
第9章 单元测试 113
9.1 TDD三定律 114
9.2 保持测试整洁 115
9.3 整洁的测试 116
9.3.1 面向特定领域的测试语言 118
9.3.2 双重标准 119
9.4 每个测试一个断言 121
9.5 F.I.R.S.T. 122
9.6 小结 123
9.7 文献 124
第10章 类 125
10.1 类的组织 126
10.2 类应该短小 126
10.2.1 单一权责原则 128
10.2.2 内聚 129
10.2.3 保持内聚性就会得到许多短小的类 130
10.3 为了修改而组织 136
10.4 文献 139
第11章 系统 141
11.1 如何建造一个城市 142
11.2 将系统的构造与使用分开 142
11.2.1 分解main 143
11.2.2 工厂 143
11.2.3 依赖注入 144
11.3 扩容 145
11.4 Java代理 148
11.5 纯Java AOP框架 150
11.6 AspectJ的方面 152
11.7 测试驱动系统架构 153
11.8 优化决策 154
11.9 明智使用添加了可论证价值的标准 154
11.10 系统需要领域特定语言 154
11.11 小结 155
11.12 文献 155
第12章 迭进 157
12.1 通过迭进设计达到整洁目的 157
12.2 简单设计规则1：运行所有测试 158
12.3 简单设计规则2～4：重构 158
12.4 不可重复 159
12.5 表达力 161
12.6 尽可能少的类和方法 162
12.7 小结 162
12.8 文献 162
第13章 并发编程 163
13.1 为什么要并发 164
13.2 挑战 165
13.3 并发防御原则 166
13.3.1 单一权责原则 166
13.3.2 推论：限制数据作用域 166
13.3.3 推论：使用数据复本 167
13.3.4 推论：线程应尽可能地独立 167
13.4 了解Java库 167
13.5 了解执行模型 168
13.5.1 生产者-消费者模型 169
13.5.2 读者-作者模型 169
13.5.3 宴席哲学家 169
13.6 警惕同步方法之间的依赖 169
13.7 保持同步区域微小 170
13.8 很难编写正确的关闭代码 170
13.9 测试线程代码 171
13.9.1 将伪失败看作可能的线程问题 171
13.9.2 先使非线程代码可工作 171
13.9.3 编写可插拔的线程代码 172
13.9.4 编写可调整的线程代码 172
13.9.5 运行多于处理器数量的线程 172
13.9.6 在不同平台上运行 172
13.9.7 装置试错代码 173
13.9.8 硬编码 173
13.9.9 自动化 174
13.10 小结 175
13.11 文献 175
第14章 逐步改进 176
14.1 Args的实现 177
14.2 Args：草稿 183
14.2.1 所以我暂停了 195
14.2.2 渐进 195
14.3 字符串参数 197
14.4 小结 234
第15章 JUnit内幕 235
15.1 JUnit框架 236
15.2 小结 249
第16章 重构SerialDate 251
16.1 首先，让它能工作 252
16.2 让它做对 254
16.3 小结 266
16.4 文献 267
第17章 味道与启发 269
17.1 注释 270
17.2 环境 271
17.3 函数 271
17.4 一般性问题 272
17.5 Java 288
17.6 名称 291
17.7 测试 294
17.8 小结 295
17.9 文献 296
附录A 并发编程II 297
A.1 客户端/服务器的例子 297
A.1.1 服务器 297
A.1.2 添加线程代码 298
A.1.3 观察服务器端 299
A.1.4 小结 301
A.2 执行的可能路径 301
A.2.1 路径数量 302
A.2.2 深入挖掘 303
A.2.3 小结 305
A.3 了解类库 305
A.3.1 Executor框架 305
A.3.2 非锁定的解决方案 306
A.3.3 非线程安全类 307
A.4 方法之间的依赖可能破坏并发代码 308
A.4.1 容忍错误 309
A.4.2 基于客户代码的锁定 309
A.4.3 基于服务端的锁定 311
A.5 提升吞吐量 312
A.5.1 单线程条件下的吞吐量 313
A.5.2 多线程条件下的吞吐量 313
A.6 死锁 314
A.6.1 互斥 315
A.6.2 上锁及等待 315
A.6.3 无抢先机制 315
A.6.4 循环等待 315
A.6.5 不互斥 316
A.6.6 不上锁及等待 316
A.6.7 满足抢先机制 317
A.6.8 不做循环等待 317
A.7 测试多线程代码 317
A.8 测试线程代码的工具支持 320
A.9 小结 320
A.10 教程：完整代码范例 321
A.10.1 客户端/服务器非线程代码 321
A.10.2 使用线程的客户端/服务器代码 324
附录B org.jfree.date.SerialDate 327
结束语 389
商品评价
- 第一章整洁代码1.大家心目中的整洁代码有什么标准？大家认为自己的代码整洁吗？2.为什么要写整洁代码？或者说混乱代码的坏处？ 1）给你一个新的模块，你花多长时间读代码，而又有多少次发现作者表达的意思跟自己理解的并不一样？–整洁代码应该是可读性强的，是简单实现，是其他人可…
- 阅读本书有两种原因：第一，你是个程序员；第二，你想成为更好的程序员。本书的观念是代码质量与整洁度成正比。干净的代码，既在质量上较为可靠，也为后期维护、升级奠定了良好基础。全书大致可分为三个部分。前几章介绍编写整洁代码的原则、模式和实践。第二部分包括几个复杂性不断增…
- 一本书的价值，主要在于读过它的人对比之前有何收获。我就主要通过我自己的收获来评价一下这本书。 在没有看过这本书之前，我认为注释是代码的很重要的一部分，没有注释的代码是不完整的。但是从来没有思考过注释和代码表达的不一致的情况。通过代码本身的命名去表达自己的想法，这…
- 第1章 先说明了通过录制自己写代码的屏幕，可以看出来读写时间之比是10：1，得出结论：让读的过程变得轻松，即使那会让写的过程更加艰难。因为从总体上来看，易读实际使之易写。第2章 说明了什么是好的命名，有些地方即使对工作多年的我仍然有启发，比如，命名不是为了区分，而是为…
- 《Clean Code》第一章举了一个很深刻却不断发生的例子，它展示了一个项目为混乱代码所付出的代价；然后列出了诸位大师眼中整洁代码的含义，最后给出了著名的“童子军军规”：让营地比你来时更干净。之后的二到十二章讲述了作者及其团队关于各种整洁代码的…
- 本书中Bob大叔提倡”写代码犹如写文章“，又说道“大师级程序员把系统当故事来讲，而不是当做程序来写”，对此观点我印象深刻！在此之前我从未听说过可以把代码当成故事、文章来写，Bob大叔太有才了！如何才能写出整洁代码呢？总的原则无非是KISS（Keep It Simple Stupid）：让代码简单…
- 不少书评都说这本书讲的太浅显了，诚然如果与《算法导论》之类的书相对比，能看懂这本书的人要多的太多了。然后看明白和能不能做到却又是完完全全的两码事。作者其实就是从他自己的经验向各位读者讲述了他认为做什么code才能成为clean code。只有看够了各种混乱不堪的代码之后你才能…
- 这是一本讲如何写好可读性高代码的书，可读性高意味着维护性高，好处是显而易见的，因为开发软件有80%的时间处于是在维护阶段。写好干净的代 码，不仅是给他人好处，也是给自己方便，因为我们也要维护/阅读自己的代码。看完这本书再翻一下Kent Beck的《Implementation Patterns》（不过…
- 一本书，尤其是工具书，它的价值，主要在于读过它的人对比之前有何收获。软件质量，不但依赖于架构及项目管理，而且与代码质量紧密相关。这一点，无论是敏捷开发流派还是传统开发流派，都不得不承认。本书提出一种观念：代码质量与其整洁度成正比。干净的代码，既在质量上较为…
- 本书主要分为三个部分。第一部分1~10章分别从概念、命名、函数、注释、格式、对象与数据结构、错误处理、边界、单元测试、类的角度讲解如何保持代码整洁；第二部分11~13章从系统层面讲解如何保持代码整洁；第三部分14~17章则是从实战的角度对之前所学内容进行演练。第1章 整洁代码什么…
全部评论: 0条