2019.05.26 周日--《阿里巴巴 Java 开发手册》精华摘要

时间 2019-11-11

标签 2019.05.26 周日阿里巴巴 Java 开发手册摘要栏目阿里巴巴繁體版

原文原文链接

1、写在开头

Java做为一个编程界最流行的语言之一，有着很强的生命力。代码的编写规范也是不容忽视的，今天，我就把本身阅读的国内的互联网巨头阿里巴巴的《阿里巴巴 Java 开发手册》一些精彩内容摘录以下。以飨读者。《阿里巴巴Java开发手册终极版v1.3.0.pdf》下载地址html

《阿里巴巴Java开发手册终极版v1.3.0.pdf》

2、精彩摘录

4.1）【命名风格】java

【01 强制】抽象类命名使用 Abstract 或 Base 开头；异常类命名使用 Exception 结尾；测试类命名以它要测试的类的名称开始，以 Test 结尾。git

【02 强制】中括号是数组类型的一部分，数组定义以下：String[] args; 反例：使用 String args[]的方式来定义。程序员

【03强制】POJO 类中布尔类型的变量，都不要加 is，不然部分框架解析会引发序列化错误。 spring

==反例：定义为基本数据类型 Boolean isDeleted；的属性，它的方法也是 isDeleted()，框架在反向解析的时候，“觉得”对应的属性名称是 deleted，致使属性获取不到，进而抛出异常。shell

【04 强制】包名统一使用小写，点分隔符之间有且仅有一个天然语义的英语单词。包名统一使用单数形式，可是类名若是有复数含义，类名可使用复数形式。正例：应用工具类包名为 com.alibaba.open.util、类名为 MessageUtils（此规则参考 spring 的框架结构）数据库

【05 推荐】若是模块、接口、类、方法使用了设计模式，在命名时体现出具体模式编程

【06 推荐】接口类中的方法和属性不要加任何修饰符号（public 也不要加），保持代码的简洁性，并加上有效的 Javadoc 注释。尽可能不要在接口里定义变量，若是必定要定义变量，确定是与接口方法相关，而且是整个应用的基础常量。正例：接口方法签名：void f(); 接口基础常量表示：String COMPANY = "alibaba"; 反例：接口方法定义：public abstract void f(); 说明：JDK8 中接口容许有默认实现，那么这个 default 方法，是对全部实现类都有价值的默认实现。设计模式

【不是很理解--todo】接口和实现类的命名有两套规则：api

1）【强制】对于 Service 和 DAO 类，基于 SOA 的理念，暴露出来的服务必定是接口，内部的实现类用 Impl 的后缀与接口区别。正例：CacheServiceImpl 实现 CacheService 接口。

2）【推荐】若是是形容能力的接口名称，取对应的形容词作接口名（一般是–able 的形式）。正例：AbstractTranslator 实现 Translatable。

4.2）【常量定义】

【不是很理解--todo】【强制】不容许任何魔法值（即未经定义的常量）直接出如今代码中。反例：String key = "Id#taobao_" + tradeId; cache.put(key, value);

4.3）【代码格式】

【01 强制】大括号的使用约定。若是是大括号内为空，则简洁地写成{}便可，不须要换行；若是是非空代码块则： 1）左大括号前不换行。 2）左大括号后换行。 3）右大括号前换行。 4）右大括号后还有 else 等代码则不换行；表示终止的右大括号后必须换行。

【02 强制】if/for/while/switch/do 等保留字与括号之间都必须加空格。

【03 强制】任何二目、三目运算符的左右两边都须要加一个空格。说明：运算符包括赋值运算符=、逻辑运算符&&、加减乘除符号等。

【04 强制】注释的双斜线与注释内容之间有且仅有一个空格。正例：// 注释内容，注意在//和注释内容之间有一个空格。

4.4）【OOP规约】

【01 强制】Object 的 equals 方法容易抛空指针异常，应使用常量或肯定有值的对象来调用 equals。

==正例："test".equals(object); 反例：object.equals("test"); 说明：推荐使用 java.util.Objects#equals（JDK7 引入的工具类）

【02 强制】全部的相同类型的包装类对象之间值的比较，所有使用 equals 方法比较。

说明：对于 Integer var = ? 在-128 至 127 范围内的赋值，Integer 对象是在 IntegerCache.cache 产生，会复用已有对象，这个区间内的 Integer 值能够直接使用==进行判断，可是这个区间以外的全部数据，都会在堆上产生，并不会复用已有对象，这是一个大坑，推荐使用 equals 方法进行判断。

关于基本数据类型与包装数据类型的使用标准以下：

1）【强制】全部的 POJO 类属性必须使用包装数据类型。

2）【强制】RPC 方法的返回值和参数必须使用包装数据类型。

3）【推荐】全部的局部变量使用基本数据类型。

==说明：POJO 类属性没有初值是提醒使用者在须要使用时，必须本身显式地进行赋值，任何 NPE (即空指针异常)问题，或者入库检查，都由使用者来保证。

==正例：数据库的查询结果多是 null，由于自动拆箱，用基本数据类型接收有 NPE 风险。

==反例：好比显示成交总额涨跌状况，即正负 x%，x 为基本数据类型，调用的 RPC 服务，调用不成功时，返回的是默认值，页面显示为 0%，这是不合理的，应该显示成中划线。因此包装数据类型的 null 值，可以表示额外的信息，如：远程调用失败，异常退出。

参考：Java中基本数据类型和包装类

【03 强制】序列化类新增属性时，请不要修改 serialVersionUID 字段，避免反序列失败；如果彻底不兼容升级，避免反序列化混乱，那么请修改 serialVersionUID 值。说明：注意 serialVersionUID 不一致会抛出序列化运行时异常。

【04 强制】POJO 类必须写 toString 方法。使用 IDE 的中工具：source> generate toString 时，若是继承了另外一个 POJO 类，注意在前面加一下 super.toString。说明：在方法执行抛出异常时，能够直接调用 POJO 的 toString()方法打印其属性值，便于排查问题。

【05 推荐】当一个类有多个构造方法，或者多个同名方法，这些方法应该按顺序放置在一块儿，便于阅读，

【06 推荐】类内方法定义顺序依次是：公有方法或保护方法 > 私有方法 > getter/setter 方法。

【07 推荐】循环体内，字符串的链接方式，使用 StringBuilder 的 append 方法进行扩展。

==说明：反编译出的字节码文件显示每次循环都会 new 出一个 StringBuilder 对象，而后进行 append 操做，最后经过 toString 方法返回 String 对象，形成内存资源浪费。

==反例： String str = "start"; for (int i = 0; i < 100; i++) { str = str + "hello"; }

【08 推荐】类成员与方法访问控制从严：

1）若是不容许外部直接经过 new 来建立对象，那么构造方法必须是 private。

2）工具类不容许有 public 或 default 构造方法。

3）类非 static 成员变量而且与子类共享，必须是 protected。

4）类非 static 成员变量而且仅在本类使用，必须是 private。

5）类 static 成员变量若是仅在本类使用，必须是 private。

6）如果 static 成员变量，必须考虑是否为 final。

7）类成员方法只供类内部调用，必须是 private。

8）类成员方法只对继承类公开，那么限制为 protected。

==说明：任何类、方法、参数、变量，严控访问范围。过于宽泛的访问范围，不利于模块解耦。思考：若是是一个 private 的方法，想删除就删除，但是一个 public 的 service 方法，或者一个 public 的成员变量，删除一下，不得手心冒点汗吗？变量像本身的小孩，尽可能在本身的视线内，变量做用域太大，无限制的处处跑，那么你会担忧的。

4.5）【集合处理】

【01 强制】关于 hashCode 和 equals 的处理，遵循以下规则：

1）只要重写 equals，就必须重写 hashCode。

2）由于 Set 存储的是不重复的对象，依据 hashCode 和 equals 进行判断，因此 Set 存储的对象必须重写这两个方法。

3）若是自定义对象作为 Map 的键，那么必须重写 hashCode 和 equals。说明：String 重写了 hashCode 和 equals 方法，因此咱们能够很是愉快地使用 String 对象做为 key 来使用。

【02 强制】ArrayList的subList结果不可强转成ArrayList，不然会抛出ClassCastException 异常，即 java.util.RandomAccessSubList cannot be cast to java.util.ArrayList.

==说明：subList 返回的是 ArrayList 的内部类 SubList，并非 ArrayList ，而是 ArrayList 的一个视图，对于 SubList 子列表的全部操做最终会反映到原列表上。

== 例子：https://blog.csdn.net/qq_15118961/article/details/80893780

【03 强制】在 subList 场景中，高度注意对原集合元素个数的修改，会致使子列表的遍历、增长、删除均会产生 ConcurrentModificationException 异常。

【04 强制】使用集合转数组的方法，必须使用集合的 toArray(T[] array)，传入的是类型彻底同样的数组，大小就是 list.size()。

【05 强制】使用工具类 Arrays.asList()把数组转换成集合时，不能使用其修改集合相关的方法，它的 add/remove/clear 方法会抛出 UnsupportedOperationException 异常。

== 说明：asList 的返回对象是一个 Arrays 内部类，并无实现集合的修改方法。Arrays.asList 体现的是适配器模式，只是转换接口，后台的数据还是数组。

==String[] str = new String[] { "you", "wu" }; List list = Arrays.asList(str); 第一种状况：list.add("yangguanbao"); 运行时异常。第二种状况：str[0] = "gujin"; 那么 list.get(0)也会随之修改。

【06 强制】泛型通配符来接收返回的数据，此写法的泛型集合不能使用 add 方法，而不能使用 get 方法，作为接口调用赋值时易出错。

==说明：扩展说一下 PECS(Producer Extends Consumer Super)原则：第1、频繁往外读取内容的，适合用<? extends T>。第2、常常往里插入的，适合用<? super T>。

【07 强制】c。remove 元素请使用 Iterator 方式，若是并发操做，须要对 Iterator 对象加锁。

【08 强制】在 JDK7 版本及以上，Comparator 要知足以下三个条件，否则 Arrays.sort， Collections.sort 会报 IllegalArgumentException 异常。

== 说明：三个条件以下 1） x，y 的比较结果和 y，x 的比较结果相反。 2） x>y，y>z，则 x>z。 3） x=y，则 x，z 比较结果和 y，z 比较结果相同。

== 参考资料：http://www.javashuo.com/article/p-exdndlvt-b.html : JAVA Comparator 接口排序用法

【09 推荐】集合初始化时，指定集合初始值大小。

==说明：HashMap 使用 HashMap(int initialCapacity) 初始化，

==正例：initialCapacity = (须要存储的元素个数 / 负载因子) + 1。注意负载因子（即 loader factor）默认为 0.75，若是暂时没法肯定初始值大小，请设置为 16（即默认值）。

== 反例：HashMap 须要放置 1024 个元素，因为没有设置容量初始大小，随着元素不断增长，容量 7 次被迫扩大，resize 须要重建 hash 表，严重影响性能。

【10 推荐】使用 entrySet 遍历 Map 类集合 KV，而不是 keySet 方式进行遍历。

==说明：keySet 实际上是遍历了 2 次，一次是转为 Iterator 对象，另外一次是从 hashMap 中取出 key 所对应的 value。而 entrySet 只是遍历了一次就把 key 和 value 都放到了 entry 中，效率更高。若是是 JDK8，使用 Map.foreach 方法。正例：values()返回的是 V 值集合，是一个 list 集合对象；keySet()返回的是 K 值集合，是一个 Set 集合对象；entrySet()返回的是 K-V 值组合集合。

== 网络例子： https://blog.csdn.net/lisiben/article/details/84855030

【11 推荐】高度注意 Map 类集合 K/V 能不能存储 null 值的状况，以下表格：

4.6）【集合处理】

【强制】获取单例对象须要保证线程安全，其中的方法也要保证线程安全。说明：资源驱动类、工具类、单例工厂类都须要注意。

4.7）【控制语句】

【01 强制】在一个 switch 块内，每一个 case 要么经过 break/return 等来终止，要么注释说明程序将继续执行到哪个 case 为止；在一个 switch 块内，都必须包含一个 default 语句而且放在最后，即便它什么代码也没有。

【02 强制】在 if/else/for/while/do 语句中必须使用大括号。即便只有一行代码，避免采用单行的编码方式：if (condition) statements;

【03 推荐】表达异常的分支时，少用 if-else 方式，这种方式能够改写成： if (condition) { ... return obj; } // 接着写 else 的业务逻辑代码;

==正例：超过 3 层的 if-else 的逻辑判断代码可使用卫语句、策略模式、状态模式等来实现，

== 参考： http://www.javashuo.com/article/p-artqhpbk-o.html

【04 推荐】循环体中的语句要考量性能，如下操做尽可能移至循环体外处理，如定义对象、变量、获取数据库链接，进行没必要要的 try-catch 操做（这个 try-catch 是否能够移至循环体外）。

4.8）【注释规约】

【01 强制】类、类属性、类方法的注释必须使用 Javadoc 规范，使用/**内容*/格式，不得使用 // xxx 方式。

【02 强制】全部的类都必须添加建立者和建立日期。

【03 强制】方法内部单行注释，在被注释语句上方另起一行，使用//注释。方法内部多行注释使用/* */注释，注意与代码对齐。

【04 参考】特殊注释标记，请注明标记人与标记时间。注意及时处理这些标记，经过标记扫描，常常清理此类标记。线上故障有时候就是来源于这些标记处的代码。

== 1）待办事宜（TODO）:（标记人，标记时间，[预计处理时间]）表示须要实现，但目前还未实现的功能。这其实是一个 Javadoc 的标签，目前的 Javadoc 尚未实现，但已经被普遍使用。只能应用于类，接口和方法（由于它是一个 Javadoc 标签）。

== 2）错误，不能工做（FIXME）:（标记人，标记时间，[预计处理时间]）在注释中用 FIXME 标记某代码是错误的，并且不能工做，须要及时纠正的状况。

4.9）【其余】

【01 强制】后台输送给页面的变量必须加$!{var}——中间的感叹号。说明：若是 var=null 或者不存在，那么${var}会直接显示在页面上。

【02 强制】注意 Math.random() 这个方法返回是 double 类型，注意取值的范围 0≤x<1（可以取到零值，注意除零异常），若是想获取整数类型的随机数，不要将 x 放大 10 的若干倍而后取整，直接使用 Random 对象的 nextInt 或者 nextLong 方法。

【03 强制】获取当前毫秒数 System.currentTimeMillis(); 而不是 new Date().getTime(); 说明：若是想获取更加精确的纳秒级时间值，使用 System.nanoTime()的方式。在 JDK8 中，针对统计时间等场景，推荐使用 Instant 类。

【04 推荐】任何数据结构的构造或初始化，都应指定大小，避免数据结构无限增加吃光内存。

【05 推荐】及时清理再也不使用的代码段或配置信息。说明：对于垃圾代码或过期配置，坚定清理干净，避免程序过分臃肿，代码冗余。

== 正例：对于暂时被注释掉，后续可能恢复使用的代码片段，在注释代码上方，统一规定使用三个斜杠(///)来讲明注释掉代码的理由。

4.10）【异常处理】

【01 强制】对大段代码进行 try-catch，这是不负责任的表现。catch 时请分清稳定代码和非稳定代码，稳定代码指的是不管如何不会出错的代码。对于非稳定代码的 catch 尽量进行区分异常类型，再作对应的异常处理。

【02 参考】在代码中使用“抛异常”仍是“返回错误码”，对于公司外的 http/api 开放接口必须使用“错误码”；而应用内部推荐异常抛出；跨应用间 RPC 调用优先考虑使用 Result 方式，封装 isSuccess()方法、“错误码”、“错误简短信息”。

== 说明：关于 RPC 方法返回方式使用 Result 方式的理由： 1）使用抛异常返回方式，调用方若是没有捕获到就会产生运行时错误。 2）若是不加栈信息，只是 new 自定义异常，加入本身的理解的 error message，对于调用端解决问题的帮助不会太多。若是加了栈信息，在频繁调用出错的状况下，数据序列化和传输的性能损耗也是问题。

4.11）【日志规约】

【强制】应用中不可直接使用日志系统（Log4j、Logback）中的 API，而应依赖使用日志框架 SLF4J 中的 API，使用门面模式的日志框架，有利于维护和各个类的日志处理方式统一。

【推荐】谨慎地记录日志。生产环境禁止输出 debug 日志；有选择地输出 info 日志；若是使用 warn 来记录刚上线时的业务行为信息，必定要注意日志输出量的问题，避免把服务器磁盘撑爆，并记得及时删除这些观察日志。

4.12）【单元测试】

【01 强制】好的单元测试必须遵照 AIR 原则。说明：单元测试在线上运行时，感受像空气（AIR）同样并不存在，但在测试质量的保障上，倒是很是关键的。好的单元测试宏观上来讲，具备自动化、独立性、可重复执行的特色。

 A：Automatic（自动化）  I：Independent（独立性）  R：Repeatable（可重复）

【02 强制】保持单元测试的独立性。为了保证单元测试稳定可靠且便于维护，单元测试用例之间决不能互相调用，也不能依赖执行的前后次序。

== 反例：method2 须要依赖 method1 的执行，将执行结果作为 method2 的输入。

【03 强制】对于单元测试，要保证测试粒度足够小，有助于精肯定位问题。单测粒度至可能是类级别，通常是方法级别。

【04 推荐】单元测试的基本目标：语句覆盖率达到 70%；核心模块的语句覆盖率和分支覆盖率都要达到 100%

【05 推荐】对于数据库相关的查询，更新，删除等操做，不能假设数据库里的数据是存在的，或者直接操做数据库把数据插入进去，请使用程序插入或者导入数据的方式来准备数据。

【06 推荐】单元测试做为一种质量保障手段，不建议项目发布后补充单元测试用例，建议在项目提测前完成单元测试。

4.13）【安全规约】

【01 强制】用户请求传入的任何参数必须作有效性验证。

== 说明：忽略参数校验可能致使：

 page size 过大致使内存溢出

 恶意 order by 致使数据库慢查询

 任意重定向

 SQL 注入

 反序列化注入

 正则输入源串拒绝服务 ReDoS

==说明：Java 代码用正则来验证客户端的输入，有些正则写法验证普通用户输入没有问题，可是若是攻击人员使用的是特殊构造的字符串来验证，有可能致使死循环的结果。

【02 强制】在使用平台资源，譬如短信、邮件、电话、下单、支付，必须实现正确的防重放限制，如数量限制、疲劳度控制、验证码校验，避免被滥刷、资损。说明：如注册时发送验证码到手机，若是没有限制次数和频率，那么能够利用此功能骚扰到其它用户，并形成短信平台资源浪费。

【03 推荐】发贴、评论、发送即时消息等用户生成内容的场景必须实现防刷、文本内容违禁词过滤等风控策略。

4.14）【MySQL数据库】

【01 强制】主键索引名为 pk_字段名；惟一索引名为 uk_字段名；普通索引名则为 idx_字段名。说明：pk_ 即 primary key；uk_ 即 unique key；idx_ 即 index 的简称。

【02 强制】小数类型为 decimal，禁止使用 float 和 double。

==说明：float 和 double 在存储的时候，存在精度损失的问题，极可能在值的比较时，获得不正确的结果。若是存储的数据范围超过 decimal 的范围，建议将数据拆成整数和小数分开存储。

【03 强制】varchar 是可变长字符串，不预先分配存储空间，长度不要超过 5000，若是存储长度大于此值，定义字段类型为 text，独立出来一张表，用主键来对应，避免影响其它字段索引效率。

【04 推荐】单表行数超过 500 万行或者单表容量超过 2GB，才推荐进行分库分表。说明：若是预计三年后的数据量根本达不到这个级别，请不要在建立表时就分库分表。

【05 强制】业务上具备惟一特性的字段，即便是多个字段的组合，也必须建成惟一索引。

== 说明：不要觉得惟一索引影响了 insert 速度，这个速度损耗能够忽略，但提升查找速度是明显的；另外，即便在应用层作了很是完善的校验控制，只要没有惟一索引，根据墨菲定律，必然有脏数据产生。

【06 强制】在 varchar 字段上创建索引时，必须指定索引长度，不必对全字段创建索引，根据实际文本区分度决定索引长度便可。说明：索引的长度与区分度是一对矛盾体，通常对字符串类型数据，长度为 20 的索引，区分度会高达 90%以上，可使用 count(distinct left(列名, 索引长度))/count(*)的区分度来肯定。

【07 推荐】若是有 order by 的场景，请注意利用索引的有序性。order by 最后的字段是组合索引的一部分，而且放在索引组合顺序的最后，避免出现 file_sort 的状况，影响查询性能。正例：where a=? and b=? order by c; 索引：a_b_c 反例：索引中有范围查找，那么索引有序性没法利用，如：WHERE a>10 ORDER BY b; 索引 a_b 没法排序。

【08 推荐】利用延迟关联或者子查询优化超多分页场景。

==说明：MySQL 并非跳过 offset 行，而是取 offset+N 行，而后返回放弃前 offset 行，返回 N 行，那当 offset 特别大的时候，效率就很是的低下，要么控制返回的总页数，要么对超过特定阈值的页数进行 SQL 改写。

== 正例：先快速定位须要获取的 id 段，而后再关联： SELECT a.* FROM 表 1 a, (select id from 表 1 where 条件 LIMIT 100000,20 ) b where a.id=b.id

【09 推荐】建组合索引的时候，区分度最高的在最左边。

==正例：若是 where a=? and b=? ，a 列的几乎接近于惟一值，那么只须要单建 idx_a 索引即可。

== 说明：存在非等号和等号混合判断条件时，在建索引时，请把等号条件的列前置。如：where a>? and b=? 那么即便 a 的区分度更高，也必须把 b 放在索引的最前列。

【10 推荐】防止因字段类型不一样形成的隐式转换，致使索引失效。

【11 参考】建立索引时避免有以下极端误解： 1）宁滥勿缺。认为一个查询就须要建一个索引。 2）宁缺勿滥。认为索引会消耗空间、严重拖慢更新和新增速度。 3）抵制唯一索引。认为业务的唯一性一概须要在应用层经过“先查后插”方式解决

【12 强制】不要使用 count(列名)或 count(常量)来替代 count(*)，count(*)是 SQL92 定义的标准统计行数的语法，跟数据库无关，跟 NULL 和非 NULL 无关。说明：count(*)会统计值为 NULL 的行，而 count(列名)不会统计此列为 NULL 值的行。

【13 强制】count(distinct col) 计算该列除 NULL 以外的不重复行数，注意 count(distinct col1, col2) 若是其中一列全为 NULL，那么即便另外一列有不一样的值，也返回为 0。

【14 强制】使用 ISNULL()来判断是否为 NULL 值。

==说明：NULL 与任何值的直接比较都为 NULL。 1） NULL<>NULL 的返回结果是 NULL，而不是 false。 2） NULL=NULL 的返回结果是 NULL，而不是 true。 3） NULL<>1 的返回结果是 NULL，而不是 true。

【15 参考】TRUNCATE TABLE 比 DELETE 速度快，且使用的系统和事务日志资源少，但 TRUNCATE 无事务且不触发 trigger，有可能形成事故，故不建议在开发代码中使用此语句。说明：TRUNCATE TABLE 在功能上与不带 WHERE 子句的 DELETE 语句相同。

4.15）【ORM映射】

【01 推荐】不要写一个大而全的数据更新接口。传入为 POJO 类，无论是否是本身的目标更新字段，都进行 update table setc1=value1,c2=value2,c3=value3; 这是不对的。执行 SQL 时，不要更新无改动的字段，一是易出错；二是效率低；三是增长 binlog 存储。

【02 参考】中的 compareValue 是与属性值对比的常量，通常是数字，表示相等时带上此条件；表示不为空且不为 null 时执行；表示不为 null 值时执行。

3、番外--Git的使用

【01 常见Git命令】

#【001】

统一律念：工做区：改动（增删文件和内容）

暂存区：输入命令：git add 改动的文件名，这次改动就放到了 ‘暂存区’

本地仓库(简称：本地)：输入命令：git commit 这次修改的描述，这次改动就放到了 ’本地仓库’，每一个 commit，我叫它为一个 ‘版本’。

远程仓库(简称：远程)：输入命令：git push 远程仓库，这次改动就放到了 ‘远程仓库’（GitHub 等)

commit-id：输出命令：git log，最上面那行 commit xxxxxx，后面的字符串就是 commit-id

#【002】

#编辑修改等

git show # 显示某次提交的内容 git show $id

git checkout <file-name> #放弃工做区的修改，相似于 svn revert

git revert <commit-id> #以新增一个 commit 的方式还原某一个 commit 的修改

#比较diff

git diff <branch1>..<branch2> # 在两个分支之间比较

git diff --staged # 比较暂存区和版本库差别

git diff --cached # 比较暂存区和版本库差别

git whatchanged --since='2 weeks ago' #查看两个星期内的改动

git diff --word-diff #详细展现一行中的修改

#查看提交记录

git log -p -2 # 查看最近两次详细修改内容的diff

git blame <file-name> #查看某段代码是谁写的, blame 的意思为‘责怪’，你懂的。

git reflog #显示本地更新过 HEAD 的 git 命令记录 ,相似 shell的 history

git log --all --grep='<given-text>' #在 commit log 中查找相关内容

#Git 本地分支管理

git branch -r # 查看远程分支

git branch <new_branch> # 建立新的分支

git co <branch> # 切换到某个分支

git co $id # 把某次历史提交记录checkout出来，但无分支信息，切换到其余分支会自动删除

git branch -d <branch> # 删除某个分支

git branch -vv 展现本地分支关联远程仓库的状况

git merge <branch> # 将branch分支合并到当前分支

#Git暂存管理

git stash # 暂存

git stash list # 列全部stash

git stash apply # 恢复暂存的内容

git stash drop # 删除暂存区

#Git远程分支管理

git pull --no-ff # 抓取远程仓库全部分支更新并合并到本地，不要快进合并

git push # push全部分支-- 要慎用，仍是要push具体的分支好一点 https://www.cnblogs.com/djiankuo/p/6492533.html

git push -u origin develop # 首次将本地develop分支提交到远程develop分支，而且track

git push origin master # 将本地主分支推到远程主分支

git push origin dev_20190513_registrationpath #咱们的java项目数据统计的Git push命令

#Git远程仓库管理

git remote -v # 查看远程服务器地址和仓库名称

git remote show origin # 查看远程服务器仓库状态

【02 】本地仓库“三棵树”

本地仓库由 git 维护的三棵“树”组成。

1）【图01】本地仓库git 三棵树

本地仓库git 三棵树

2）【图02】git本地三棵树的相互转化命令：https://josh-persistence.iteye.com/blog/2215214

git本地三棵树的相互转化命令

3）三棵树的更详细的命令示意图

三棵树的更详细的命令示意图

git commit的时候，只是提交的缓存区内的内容(若是你git add过，不然也等同你本地工做区内容的提交)

== git add能够实现我以前在云主机上保存临时文件的tmpdjp的操做

==git diff 对比的是工做区和缓存区的区别

==git diff --cached 对比是缓冲区和本地的 head版本库的对比

另外须要指出来的是 git stash 不在上面的“三颗树”里，git stash 是暂存区，区别于缓存区“stage”

git stash的用法见 https://www.cnblogs.com/tocy/p/git-stash-reference.html

4、写在最后

简单的摘录，见仁见智，但愿喜欢Java开发的同窗能从中收益。

欢迎关注个人微信公众号哈 “ 程序员的文娱情怀” http://t.cn/RotyZtu 😊

欢迎关注个人微信公众号哈 “ 程序员的文娱情怀”