Update： make rst

source/c02/c02_10.md

 # 2.10 反引号的妙用：结构体里的 Tag 用法
 
+![](http://image.iswbm.com/20200607145423.png)
+
 ## 1. 抛砖引玉：什么是 Tag？
 
 正常情况下，你定义的结构体是这样子的，每个字段都由名字和字段类型组成
@@ -87,9 +89,9 @@ $ go run demo.go
 Tag 由反引号包含，由一对或几对的键值对组成，通过空格来分割键值。格式如下
 
 
-   ```
+```
 `key01:"value01" key02:"value02" key03:"value03"`
-   ```
+```
 
 定义完后，如何从结构体中，取出 Tag 呢？
 
@@ -103,7 +105,7 @@ Tag 由反引号包含，由一对或几对的键值对组成，通过空格来
 
 演示如下
 
-   ```go
+```go
 // 三种获取 field
 field := reflect.TypeOf(obj).FieldByName("Name")
 field := reflect.ValueOf(obj).Type().Field(i)  // i 表示第几个字段
@@ -115,16 +117,16 @@ tag := field.Tag
 // 获取键值对
 labelValue := tag.Get("label")
 labelValue,ok := tag.Lookup("label")
-   ```
+```
 
  获取键值对，有Get 和 Lookup 两种方法，但其实 Get 只是对 Lookup 函数的简单封装而已，当没有获取到对应 tag 的内容，会返回空字符串。
 
-   ```go
+```go
 func (tag StructTag) Get(key string) string {
     v, _ := tag.Lookup(key)
     return v
 }
-   ```
+```
 
 空 Tag 和不设置 Tag 效果是一样的
 
@@ -177,7 +179,7 @@ Print(person)
 就像下面这样，key 和 value 之间有个 `is:`，如果没有指定 Gender 的值，那么显示为unknown（未知）。
 
 ```shell
-Person Name: MING
+Name is: MING
 Age is: 29
 Gender is: unknown
 ```
@@ -238,7 +240,5 @@ Gender is: unknown
 
 
 
-
-
 ![](http://image.iswbm.com/20200607174235.png)
 

source/c02/c02_10.rst

 2.10 反引号的妙用：结构体里的 Tag 用法
 ======================================
 
+|image0|
+
+1. 抛砖引玉：什么是 Tag？
+-------------------------
+
 正常情况下，你定义的结构体是这样子的，每个字段都由名字和字段类型组成
 
 .. code:: go
@@ -85,14 +90,84 @@ Tag，也就是标签。
    {"name":"Jack","age":22}
    {"name":"Jack","age":22,"addr":"China"}
 
-那么问题就来了，通过 tag ，是如何做到这样的效果呢？
+2. 不懂就问：如何定义获取 Tag ？
+--------------------------------
+
+Tag 由反引号包含，由一对或几对的键值对组成，通过空格来分割键值。格式如下
+
+::
+
+   `key01:"value01" key02:"value02" key03:"value03"`
 
-答案就是我们前几篇文章提到的 “**反射**”。
+定义完后，如何从结构体中，取出 Tag 呢？
 
-通过反射，可以从一个结构体对象中获得 tag 属性，然后进行解析，根据不同的
-tag 属性来实现不同的逻辑。
+答案就是，我们上一节学过的 “反射”。
 
-这边我举个例子吧
+获取 Tag 可以分为三个步骤：
+
+1. 获取字段 field
+2. 获取标签 tag
+3. 获取键值对 key:value
+
+演示如下
+
+.. code:: go
+
+   // 三种获取 field
+   field := reflect.TypeOf(obj).FieldByName("Name")
+   field := reflect.ValueOf(obj).Type().Field(i)  // i 表示第几个字段
+   field := reflect.ValueOf(&obj).Elem().Type().Field(i)  // i 表示第几个字段
+
+   // 获取 Tag
+   tag := field.Tag 
+
+   // 获取键值对
+   labelValue := tag.Get("label")
+   labelValue,ok := tag.Lookup("label")
+
+获取键值对，有Get 和 Lookup 两种方法，但其实 Get 只是对 Lookup
+函数的简单封装而已，当没有获取到对应 tag 的内容，会返回空字符串。
+
+.. code:: go
+
+   func (tag StructTag) Get(key string) string {
+       v, _ := tag.Lookup(key)
+       return v
+   }
+
+空 Tag 和不设置 Tag 效果是一样的
+
+.. code:: go
+
+   package main
+
+   import (
+       "fmt"
+       "reflect"
+   )
+
+   type Person struct {
+       Name string ``
+       Age string
+   }
+   func main() {
+       p := reflect.TypeOf(Person{})
+       name, _ := p.FieldByName("Name")
+       fmt.Printf("%q\n", name.Tag) //输出 ""
+       age, _ := p.FieldByName("Age")
+       fmt.Printf("%q\n", age.Tag) // 输出 ""
+   }
+
+3. 实战一下：利用 Tag 搞点事情？
+--------------------------------
+
+学会了如何定义 tag 和 获取 tag，可以试着利用 tag
+来做一些事情，来练习一下。
+
+这边我举个例子吧。
+
+如果我想实现一个函数（就叫 Print 吧），在打印 person
+对象时，能够美化输出
 
 .. code:: go
 
@@ -107,15 +182,14 @@ tag 属性来实现不同的逻辑。
        Age:         29,
    }
 
-   Print(&person)
+   Print(person)
 
-如果我想实现一个函数（就叫 Print 吧），在打印 person
-对象时，能够美化输出，就像下面这样，key 和 value 之间有个
-``is:``\ ，如果没有指定 Gender 的值，那么显示为unknown（未知）。
+就像下面这样，key 和 value 之间有个 ``is:``\ ，如果没有指定 Gender
+的值，那么显示为unknown（未知）。
 
 .. code:: shell
 
-   Person Name: MING
+   Name is: MING
    Age is: 29
    Gender is: unknown
 
@@ -136,25 +210,16 @@ label 属性，而 Gender 多了一个 default 属性，意在指定默认值。
 
 .. code:: go
 
-   func Print(ptr interface{}) error {
-
-       // 获取入参的类型
-       t := reflect.TypeOf(ptr)
-
-       // 入参类型校验
-       if t.Kind() != reflect.Ptr || t.Elem().Kind() != reflect.Struct {
-           return fmt.Errorf("参数应该为结构体指针")
-       }
-
-       // 取指针指向的结构体变量
-       v := reflect.ValueOf(ptr).Elem()
+   func Print(obj interface{}) error {
+       // 取 Value
+       v := reflect.ValueOf(obj)
 
        // 解析字段
        for i := 0; i < v.NumField(); i++ {
 
            // 取tag
-           fieldInfo := v.Type().Field(i)
-           tag := fieldInfo.Tag
+           field := v.Type().Field(i)
+           tag := field.Tag
 
            // 解析label 和 default
            label := tag.Get("label")
@@ -181,7 +246,10 @@ label 属性，而 Gender 多了一个 default 属性，意在指定默认值。
    Age is: 29
    Gender is: unknown
 
-|image0|
+到此，我们就把 Tag 的用法介绍完了。
+
+|image1|
 
-.. |image0| image:: http://image.iswbm.com/20200607174235.png
+.. |image0| image:: http://image.iswbm.com/20200607145423.png
+.. |image1| image:: http://image.iswbm.com/20200607174235.png