工作第一天 看看这个吧~~ 修炼内功必备 呵呵~ 第1章 假想的编译程序 读者可以考虑一下倘若编译程序能够正确地指出代码中的所有问题，那相应程序的错误情况会怎样？这不单指语法错误，还包括程序中的任何问题，不管它有多么隐蔽。例如，假定程序中有“差1”错误，编译程序可以采用某种方法将其查出，并给出如下的错误信息 -> line 23: while (i<=j) off by one error: this should be '<' 又如，编译程序可以发现算法中有下面的错误： -> line 42: int itoa(int i, char* str) algorithm error: itoa fails when i is -32768 再如，当出现了参数传递错误时，编译程序可以给出如下的错误信息： -> line 318: strCopy = memcpy(malloc(length), str, length); Invalid argument: memcpy fails when malloc returns NULL 好了，要求编译程序能够做到这一程度似乎有点过分。但如编译程序真能做到这些，可以想象编写无错程序会变得多么容易。那简直是小事一桩，和当前程序员的一般作法真没法比。 假如在间谍卫星上用摄像机对准某个典型的软件车间．就会看到程序员们正弓着身子趴在键盘上跟踪错误；旁边，测试者正在对刚作出的内部版本发起攻击，轮番轰炸式地输入人量的数据以求找出新的错误。你还会发现，测试员正在检查老版本的错误是否溜进了新版本。可以推想，这种查错方法比用上面的假想编译程序进行查错要花费大得多的工作量、确实如此，而且它还要有点运气。 运气？

cleancode，顾名思义就是整洁的代码，或者说清晰、漂亮的代码，相信大多数工程师都希望自己能写出这样的代码。也许这是个千人千面的话题，每个工程师都有自己的理解。比如我，从一个天天被骂代码写得烂的人，逐渐学习成长，到现在也能写的出“人模人样”的代码来了。这期间算是积累了一点经验心得，想和大家分享，抛砖引玉。本文主要针对面向对象编程的cleancode来阐述，面向过程代码的思路会比较不同，不在本文的讨论范畴。代码大部分时候是用来维护的，而不是用来实现功能的这个原则适用于大部分的工程。我们的代码，一方面是编译好让机器执行，完成功能需求；另一方面，是写给身边的队友和自己看的，需要长期维护，而且大部

代码整洁直到，怎么写出简介代码。 本版本 为高清扫描，有目录的

CleanCode(代码整洁之道)中英文合集。

代码整洁之道-Clean Code 清晰带书签版 pdf格式 个人阅读完毕，非常好的一本编程指导书籍 自己添加的书签 非常方便阅读 希望共享给大家！

Clean Code 代码整洁之道 （英文版+中文版），软件工程参考书电子版，英文原版+中文翻译版。【美】Robert C. Martin 著， 韩磊 译目录：第1章 整洁代码 11.1 要有代码 2 1.2 糟糕的代码 21.3 混乱的代价 31.3.1 华丽新设计 41.3.2 态度 41.3.3 迷题 51.3.4 整洁代码的艺术 51.3.5 什么是整洁代码 61.4 思想流派 101.5 我们是作者 111.6 童子军军规 121.7 前传与原则 12 1.8 小结 121.9 文献 13第2章 有意义的命名 152.1 介绍 152.2 名副其实 162.3 避免误导 172.4 做有意义的区分 182.5 使用读得出来的名称 192.6 使用可搜索的名称 20 2.7 避免使用编码 212.7.1 匈牙利语标记法 212.7.2 成员前缀 212.7.3 接口和实现 222.8 避免思维映射 222.9 类名 232.10 方法名 232.11 别扮可爱 232.12 每个概念对应一个词 242.13 别用双关语 242.14 使用解决方案领域名称 252.15 使用源自所涉问题领域的名称 252.16 添加有意义的语境 252.17 不要添加没用的语境 272.18 最后的话 27第3章 函数 293.1 短小 323.2 只做一件事 333.3 每个函数一个抽象层级 343.4 switch语句 353.5 使用描述性的名称 363.6 函数参数 373.6.1 一元函数的普遍形式 383.6.2 标识参数 383.6.3 二元函数 383.6.4 三元函数 393.6.5 参数对象 393.6.6 参数列表 403.6.7 动词与关键字 403.7 无副作用 403.8 分隔指令与询问 423.9 使用异常替代返回错误码 42 3.9.1 抽离Try/Catch代码块 433.9.2 错误处理就是一件事 443.9.3 Error.java依赖磁铁 443.10 别重复自己 443.11 结构化编程 453.12 如何写出这样的函数 453.13 小结 453.14 SetupTeardownIncluder程序 46 3.15 文献 48第4章 注释 494.1 注释不能美化糟糕的代码 504.2 用代码来阐述 514.3 好注释 514.3.1 法律信息 514.3.2 提供信息的注释 514.3.3 对意图的解释 524.3.4 阐释 53 4.3.5 警示 534.3.6 TODO注释 544.3.7 放大 544.3.8 公共API中的Javadoc 554.4 坏注释 554.4.1 喃喃自语 554.4.2 多余的注释 564.4.3 误导性注释 584.4.4 循规式注释 584.4.5 日志式注释 59 4.4.6 废话注释 594.4.7 可怕的废话 614.4.8 能用函数或变量时就别用注释 624.4.9 位置标记 624.4.10 括号后面的注释 624.4.11 归属与署名 634.4.12 注释掉的代码 634.4.13 HTML注释 644.4.14 非本地信息 644.4.15 信息过多 654.4.16 不明显的联系 65 4.4.17 函数头 664.4.18 非公共代码中的Javadoc 664.4.19 范例 664.5 文献 69第5章 格式 715.1 格式的目的 725.2 垂直格式 725.2.1 向报纸学习 735.2.2 概念间垂直方向上的区隔 73 5.2.3 垂直方向上的靠近 745.2.4 垂直距离 755.2.5 垂直顺序 795.3 横向格式 795.3.1 水平方向上的区隔与靠近 805.3.2 水平对齐 815.3.3 缩进 825.3.4 空范围 845.4 团队规则 845.5 鲍勃大叔的格式规则 85第6章 对象和数据结构 87 6.1 数据抽象 876.2 数据、对象的反对称性 896.3 得墨忒耳律 916.3.1 火车失事 916.3.2 混杂 926.3.3 隐藏结构 926.4 数据传送对象 936.5 小结 94 6.6 文献 94第7章 错误处理 957.1 使用异常而非返回码 9

《Clean Code(评注版)》提出一种观念：代码质量与其整洁度成正比。干净的代码，既在质量上较为可靠，也为后期维护、升级奠定了良好的基础。《Clean Code(评注版)》作者给出了一系列行之有效的整洁代码操作实践。这些实践在《Clean Code(评注版)》中体现为一条条规则（或称“启示”）

clean code-代码整洁之道(中文完整版-带书签).pdf

《代码整洁之道》阅读对象为一切有志于改善代码质量的程序员及技术经理。书中介绍的规则均来自作者多年的实践经验，涵盖从命名到重构的多个编程方面，虽为一“家”之言，然诚有可资借鉴的价值。