update

Author: cnwyt

docs/README.md

@@ -172,8 +172,45 @@ $ go env GOPATH
 $ go env -w GOPROXY=https://goproxy.cn,direct
 ```
 
+关于 GOPATH： 
+
+The `GOPATH` environment variable specifies the location of your workspace. 
+
+It defaults to a directory named `go`inside your home directory, so `$HOME/go` on Unix, `$home/go` on Plan 9, and `%USERPROFILE%\go` (usually `C:\Users\YourName\go`) on Windows.
+
+
+```sh
+$ tree -L 3 ~/go 
+/Users/wangtom/go
+├── bin
+│   ├── go-outline
+│   ├── goimports
+│   └── gopls
+├── pkg
+│   ├── darwin_amd64
+│   │   └── github.com
+│   ├── mod
+│   │   ├── cache
+│   │   ├── github.com
+│   │   ├── golang.org
+│   │   ├── google.golang.org
+│   │   ├── gopkg.in
+│   │   └── honnef.co
+│   └── sumdb
+│       └── sum.golang.org
+└── src
+    └── github.com
+        └── go-sql-driver
+```
+
+
 ## 创建 go modules 模块: 
 
+我们知道 `go get` 获取的代码会放在 `$GOPATH/src` 下面，而`go build`会在`$GOROOT/src`和`$GOPATH/src`下面按照import path去搜索`package`。
+
+每个go.mod文件定义了一个module，而放置go.mod文件的目录被称为module root目录（通常对应一个repo的root目录，但不是必须的）。module root目录以及其子目录下的所有Go package均归属于该module，除了那些自身包含go.mod文件的子目录。
+
+
 大多数编程语言都会有包管理工具，像Node有`npm`，PHP有`composer`，Java有`Maven`和`Gradle`。 
 可是，Go语言一直缺乏一个官方的包管理(曾有一个`Dep`被称为官方试验品`official experiment`)。
 终于，在`go1.11` 版本中，新增了`module`管理模块功能，用来管理依赖包。

examples/go-mod-demo/.env

@@ -0,0 +1,3 @@
+APP_NAME=Go-Mod-DEMO
+APP_DEBUG=true
+APP_VERSION=0.0.1

examples/go-mod-demo/README.md

@@ -0,0 +1,84 @@
+README.md
+
+
+```
+$ mkdir go-mod-demo 
+$ cd go-mod-demo
+
+$ ll
+total 16
+-rw-r--r--  1 wangtom  staff     9B 12  2 11:09 README.md
+-rw-r--r--  1 wangtom  staff   192B 12  2 11:08 main.go 
+```
+
+
+$ go mod init go-mod-demo
+go: creating new go.mod: module go-mod-demo
+
+```
+$ cat go.mod 
+module go-mod-demo
+
+go 1.13
+```
+
+
+go list -m输出的信息被称为build list，也就是构建当前module所要构建的所有相关package（及版本）的列表。
+
+```
+$ go list -m -json all
+{
+	"Path": "go-mod-demo",
+	"Main": true,
+	"Dir": "/Users/wangtom/Code/golang-quick-start/examples/go-mod-demo",
+	"GoMod": "/Users/wangtom/Code/golang-quick-start/examples/go-mod-demo/go.mod",
+	"GoVersion": "1.13"
+}
+```
+
+
+```sh
+$ go get -u github.com/joho/godotenv
+$ ll
+total 32
+-rw-r--r--  1 wangtom  staff   695B 12  2 11:19 README.md
+-rw-r--r--  1 wangtom  staff    81B 12  2 11:21 go.mod
+-rw-r--r--  1 wangtom  staff   167B 12  2 11:21 go.sum
+-rw-r--r--  1 wangtom  staff   192B 12  2 11:08 main.go
+```
+
+
+```sh
+$ cat go.mod 
+module go-mod-demo
+
+go 1.13
+
+require github.com/joho/godotenv v1.3.0 // indirect
+```
+➜  go-mod-demo git:(master) ✗ 
+
+
+使用 go mod 的依赖包会被安装在 `~/go/pkg/mod/` 命令下：
+
+```sh
+$ ll ~/go/pkg/mod/github.com/joho/godotenv@v1.3.0/
+total 80
+-r--r--r--  1 wangtom  staff   1.0K 12  2 09:40 LICENCE
+-r--r--r--  1 wangtom  staff   4.8K 12  2 09:40 README.md
+dr-xr-xr-x  3 wangtom  staff    96B 12  2 09:40 autoload
+dr-xr-xr-x  3 wangtom  staff    96B 12  2 09:40 cmd
+dr-xr-xr-x  8 wangtom  staff   256B 12  2 09:40 fixtures
+-r--r--r--  1 wangtom  staff   8.6K 12  2 09:40 godotenv.go
+-r--r--r--  1 wangtom  staff    12K 12  2 09:40 godotenv_test.go
+```
+
+
+
+vi .env
+
+APP_NAME=Go-Mod-DEMO
+APP_DEBUG=true
+APP_VERSION=0.0.1
+
+

examples/go-mod-demo/go.mod

@@ -0,0 +1,5 @@
+module go-mod-demo
+
+go 1.13
+
+require github.com/joho/godotenv v1.3.0 // indirect

examples/go-mod-demo/go.sum

@@ -0,0 +1,2 @@
+github.com/joho/godotenv v1.3.0 h1:Zjp+RcGpHhGlrMbJzXTrZZPrWj+1vfm90La1wgB6Bhc=
+github.com/joho/godotenv v1.3.0/go.mod h1:7hK45KPybAkOC6peb+G5yklZfMxEjkZhHbwpqxOKXbg=

examples/go-mod-demo/main.go

@@ -0,0 +1,29 @@
+package main
+
+import (
+	"log"
+	"os"
+	"time"
+
+	"github.com/joho/godotenv"
+)
+
+func main() {
+
+	log.Println("Hello, World!")
+
+	log.Printf("Unix timestamp:  %d \n", time.Now().Unix())
+
+	err := godotenv.Load()
+	if err != nil {
+
+		log.Fatal("Error loading .env file")
+	}
+
+	appName := os.Getenv("APP_NAME")
+	isDebug := os.Getenv("APP_DEBUG")
+
+	log.Println("APP_NAME: ", appName)
+	log.Println("APP_DEBUGL: ", isDebug)
+
+}