编写可读代码的艺术
Dustin Boswell, Trevor Foucher
尹哲, 郑秀雯 译
出版时间:2012年06月
页数:178
“软件开发的一个重要部分是要意识到你的代码以后将如何影响查看这些代码的人。两位作者高屋建瓴,带你领略这一挑战的各个方面,并且使用有指导意义的例子来解释细节。”
——Michael Hunger,软件开发人员

细节决定成败,思路清晰、言简意赅的代码让程序员一目了然;而格式凌乱、拖沓冗长的代码让程序员一头雾水。除了可以正确运行以外,优秀的代码必须具备良好的可读性,编写的代码要使其他人能在最短的时间内理解才行。本书旨在强调代码对人的友好性和可读性。
本书关注编码的细节,总结了很多提高代码可读性的小技巧,看似都微不足道,但是对于整个软件系统的开发而言,它们与宏观的架构决策、设计思想、指导原则同样重要。编码不仅仅只是一种技术,也是一门艺术,编写可读性高的代码尤其如此。如果你要成为一位优秀的程序员,要想开发出高质量的软件系统,必须从细处着手,做到内外兼修,本书将为你提供有效的指导。

主要内容:
· 简化命名、注释和格式的方法,使每行代码都言简意赅。
· 梳理程序中的循环、逻辑和变量来减小复杂度并理清思路。
· 在函数级别解决问题,例如重新组织代码块,使其一次只做一件事。
· 编写有效的测试代码,使其全面而简洁,同时可读性更高。

Dustin Boswell毕业于加州理工大学,资深软件工程师,在Google就职多年,负责Web爬虫和程序设计相关的工作。他专注于前端、后端,服务器架构、机器学习、大数据、系统和网站等技术领域的研究和实践,经验十分丰富。他现在是MyLikes的软件工程师。
Trevor Foucher资深软件工程师和技术经理,先后在Microsoft和Google工作了数十年,在Microsoft担任软件工程师、技术经理以及安全产品技术主管,在Google从事广告应用开发和搜索基础结构研发相关的工作。
  1. 前言
  2. 第1章 代码应当易于理解
  3. 是什么让代码变得“更好”
  4. 可读性基本定理
  5. 总是越小越好吗
  6. 理解代码所需的时间是否与其他目标有冲突
  7. 最难的部分
  8. 第一部分 表面层次的改进
  9. 第2章 把信息装到名字里
  10. 选择专业的词
  11. 避免像tmp和retval这样泛泛的名字
  12. 用具体的名字代替抽象的名字
  13. 为名字附带更多信息
  14. 名字应该有多长
  15. 利用名字的格式来传递含义
  16. 总结
  17. 第3章 不会误解的名字
  18. 例子:Filter()
  19. 例子:Clip(text, length)
  20. 推荐用first和last来表示包含的范围
  21. 推荐用begin和end来表示包含/排除范围
  22. 给布尔值命名
  23. 与使用者的期望相匹配
  24. 例子:如何权衡多个备选名字
  25. 总结
  26. 第4章 审美
  27. 为什么审美这么重要
  28. 重新安排换行来保持一致和紧凑
  29. 用方法来整理不规则的东西
  30. 在需要时使用列对齐
  31. 选一个有意义的顺序,始终一致地使用它
  32. 把声明按块组织起来
  33. 把代码分成“段落”
  34. 个人风格与一致性
  35. 总结
  36. 第5章 该写什么样的注释
  37. 什么不需要注释
  38. 记录你的思想
  39. 站在读者的角度
  40. 最后的思考——克服“作者心理阻滞”
  41. 总结
  42. 第6章 写出言简意赅的注释
  43. 让注释保持紧凑
  44. 避免使用不明确的代词
  45. 润色粗糙的句子
  46. 精确地描述函数的行为
  47. 用输入/输出例子来说明特别的情况
  48. 声明代码的意图
  49. “具名函数参数”的注释
  50. 采用信息含量高的词
  51. 总结
  52. 第二部分 简化循环和逻辑
  53. 第7章 把控制流变得易读
  54. 条件语句中参数的顺序
  55. if/else语句块的顺序
  56. ?:条件表达式(又名“三目运算符”)
  57. 避免do/while循环
  58. 从函数中提前返回
  59. 臭名昭著的goto
  60. 最小化嵌套
  61. 你能理解执行的流程吗
  62. 总结
  63. 第8章 拆分超长的表达式
  64. 用做解释的变量
  65. 总结变量
  66. 使用德摩根定理
  67. 滥用短路逻辑
  68. 例子:与复杂的逻辑战斗
  69. 拆分巨大的语句
  70. 另一个简化表达式的创意方法
  71. 总结
  72. 第9章 变量与可读性
  73. 减少变量
  74. 缩小变量的作用域
  75. 只写一次的变量更好
  76. 最后的例子
  77. 总结
  78. 第三部分 重新组织代码
  79. 第10章 抽取不相关的子问题
  80. 介绍性的例子:findClosestLocation()
  81. 纯工具代码
  82. 其他多用途代码
  83. 创建大量通用代码
  84. 项目专有的功能
  85. 简化已有接口
  86. 按需重塑接口
  87. 过犹不及
  88. 总结
  89. 第11章 一次只做一件事
  90. 任务可以很小
  91. 从对象中抽取值
  92. 更大型的例子
  93. 总结
  94. 第12章 把想法变成代码
  95. 清楚地描述逻辑
  96. 了解函数库是有帮助的
  97. 把这个方法应用于更大的问题
  98. 总结
  99. 第13章 少写代码
  100. 别费神实现那个功能——你不会需要它
  101. 质疑和拆分你的需求
  102. 保持小代码库
  103. 熟悉你周边的库
  104. 例子:使用Unix工具而非编写代码
  105. 总结
  106. 第四部分 精选话题
  107. 第14章 测试与可读性
  108. 使测试易于阅读和维护
  109. 这段测试什么地方不对
  110. 使这个测试更可读
  111. 让错误消息具有可读性
  112. 选择好的测试输入
  113. 为测试函数命名
  114. 那个测试有什么地方不对
  115. 对测试友好的开发方式
  116. 走得太远
  117. 总结
  118. 第15章 设计并改进“分钟/小时计数器”
  119. 问题
  120. 定义类接口
  121. 尝试1:一个幼稚的方案
  122. 尝试2:传送带设计方案
  123. 尝试3:时间桶设计方案
  124. 比较三种方案
  125. 总结
  126. 附录 深入阅读
书名:编写可读代码的艺术
译者:尹哲, 郑秀雯 译
国内出版社:机械工业出版社
出版时间:2012年06月
页数:178
书号:978-7-111-38544-8
原版书书名:The Art of Readable Code
原版书出版商:O'Reilly Media
Dustin Boswell
 
尽管在马戏团长大,Dustin Boswell很早就发现他更擅长计算机而不是杂技。Dustin在加州理工学院得到了他的本科学位,在那里他爱上了计算机科学,于是后来去圣地亚哥加利福尼亚大学读研究生。他在Google工作了5年,从事过不同的项目,包括网页爬虫的基础结构。他建立了数个网站并且喜欢从事“大数据”和机器学习方面的工作。Dustin目前在一家Internet创业公司工作,他空闲时间会去圣摩尼卡山中徒步旅行,并且他刚刚做了父亲。
 
 
Trevor Foucher
 
Trevor Foucher在微软和Google从事了超过10年的大型软件开发。他现在是Google的一名搜索基础结构工程师。在他的业余时间里,他参与游戏聚会,阅读科幻小说,并且是他妻子的时装创业公司的COO。Trevor毕业于加州大学伯克利分校,获得电气工程和计算机科学的本科学位。