GoFrame系列：2、Windows下搭建環境準備

實際上這塊的內容跳出了GoFrame的范疇，比較細致的描述了Go的安裝、GoLand的如何配置Go Modules以及設定Go的環境變數和GoLand常用的工具，更像是Go的基礎教程的一部分，因此，如果已經設定了Go+GoLand的開發環境，這部分可以跳過，

1. Go+GoLand環境安裝

Go開發包+GoLand開發工具：

不知道的可以看這里：https://blog.csdn.net/weixin_39510813/article/details/114892586和https://blog.csdn.net/weixin_39510813/article/details/115012762（一般從https://golang.org/dl/直接下載安裝檔案安裝即可），當然檔案中也很細致，也有簡單的教程，

GoLand下載地址：https://www.jetbrains.com/go/download/#section=windows

較新版本的都可以通過搜索安裝Chinese語言插件漢化，

如下是GoLand創建專案的簡單程序：

新建一個go檔案，叫做hello.go，并輸入以下代碼:

package main

import "fmt"

func main() {
    fmt.Println("hello world!")
}

執行運行：

2. Go Module

Go Module是從Go版本1.11.1開始官方提供的包管理工具，用于解決Go專案的包管理及依賴，類似于PHP的composer、Nodejs的npm，本章節會對Go Module的一些常用的實用的命令/設定進行介紹，更詳細的介紹請查看官方檔案：https://github.com/golang/go/wiki/Modules

2.1 關于go.mod

go.mod是Go專案的依賴描述檔案，該檔案主要用來描述兩個事情：

1. 當前專案名(module)是什么，每個專案都應該設定一個名稱，當前專案中的包(package)可以使用該名稱進行相互呼叫，
2. 當前專案依賴的第三方包名稱，專案運行時會自動分析專案中的代碼依賴，生成go.sum依賴分析結果，隨后go編譯器會去下載這些第三方包，然后再編譯運行，

我們將之前的hello world專案做一些改變，增加一個go.mod檔案（也可以在專案根目錄下使用 go mod init 專案名稱命令初始化專案生成該檔案），內容如下：

module my-hello

其中，my-hello為當前專案的名稱，可以隨意設定，

就這樣簡單便完成了專案的module初始化，

一般情況下，go.sum依賴分析檔案應當被添加到版本管理中隨著go.mod檔案一起提交，

2.2 使用go.mod

使用go.mod意即用go.mod進行專案依賴管理，我們有兩種go.mod的使用方式：IDE-vgo和命令列方式，以下我們通過下載使用GoFrame框架來演示如何使用這兩種方式來管理依賴，

如果需要Goland IDE支持go.mod，必須要打開vgo的支持（包括代碼依賴檢測），這兩種使用方式的區別僅僅是下載依賴包的方式不同，

2.2.1 使用Goland IDE vgo（推薦）

vgo是基于Go Module規范的包管理工具，同官方的go mod命令工具類似，

• 1.設定Goland啟用vgo

其中Proxy請輸入代理地址下載依賴包，如果選擇direct表示不使用代理，可選擇的反向代理地址有：

• https://goproxy.cn
• https://goproxy.io
• https://mirrors.aliyun.com/goproxy/

詳見Go官網說明：https://github.com/golang/go/wiki/Modules#are-there-always-on-module-repositories-and-enterprise-proxies

這里請務必選擇一個代理地址輸入，

• 2.手動修改go.mod檔案如下：

module my-hello

require github.com/gogf/gf latest

增加GoFrame框架的依賴，其中latest表示使用最新版本，IDE將會立即去更新下載框架代碼，成功后，IDE將會修改go.mod檔案并生成go.sum依賴分析檔案，

如果出現包飄紅的情況，則根據提示進行包同步即可，一般來說配置好代理下載是不會有什么問題的，

下載同步完成后編譯運行如下所示：

2.2.2 使用命令列

打開Terminal，在專案根目錄下執行:

export GO111MODULE=on GOPROXY=https://goproxy.cn; go get -u github.com/gogf/gf

該命令將會立即下載最新穩定版本的GoFrame框架，其中 export GO111MODULE=on; 表示開啟Go Module特性（Go 1.11.x版本默認關閉，需要手動開啟），export GOPROXY=https://goproxy.cn 表示使用代理下載，原因你懂的，并且也能極大提高依賴包下載速度，代理地址也可使用：

• https://goproxy.cn
• https://goproxy.io
• https://mirrors.aliyun.com/goproxy

對于命令列的方式我一般會將一些命令寫到腳本中執行，

2.3 使用GoFrame

我們將之前的hello.go修改如下：

package main

import (
    "fmt"
    "github.com/gogf/gf"
)

func main() {
    fmt.Println("hello GF", gf.VERSION)
}

運行結果如上圖所示，

3. 開發環境配置

3.1 Go環境變數

為方便開發，在開發環境往往需要設定三個環境變數：

1. $GOROOT：go的安裝目錄，配置后不會再更改；
2. $GOPATH：go專案在本地的開發環境的的專案根路徑(以便專案編譯，go build, go install)，不同的專案在編譯的時候該環境變數可以不同；
3. $PATH（重要）：需要將go的bin目錄添加到系統$PATH中以便方便使用go的相關命令，配置后也不會再更改；

Go的環境變數在官方檔案中也有詳情的說明，請參考鏈接：https://golang.google.cn/doc/install/source

環境變數中的$GOOS和$GOARCH是比較實用的兩個變數，可以用在不同平臺的交叉編譯中，只需要在go build之前設定這兩個變數即可，這也是go語言的優勢之一：可以編譯生成跨平臺運行的可執行檔案，感覺比QT更高效更輕量級，雖然生成的可執行檔案是大了一點，不過也在可接受的范圍之內， 例如，在Linux amd64架構下編譯Windows x86的可執行檔案，可以使用如下命令：

CGO_ENABLED=0 GOOS=windows GOARCH=386 go build hello.go

遺憾的是交叉編譯暫不支持cgo方式，因此需要將環境變數$CGO_ENABLED設定為0，這樣執行之后會在當前目錄生成一個hello.exe的windows x86架構的可執行檔案，

3.2 環境變數設定

除了$PATH環境外，其他環境變數都是可選的，

為什么說這個步驟可選呢？因為未來的Go版本慢慢開始移除對$GOPATH/$GOROOT的支持，此外，在Goland這個IDE中集成有Terminal功能，直接使用這個功能中已經設定好了環境變數，

3.2.1 *nix下設定環境變數

在*nix系統下(Linux/Unix/MacOS/*BSD等等)，需要在/etc/profile中增加以下環境變數設定后，執行命令#source /etc/profile重新加載profile組態檔（或重新登錄），將以下變數添加到用戶的環境變數中:

export GOROOT=/usr/local/go
export GOPATH=/Users/john/Workspace/Go/GOPATH
export PATH=$GOPATH/bin:$GOROOT/bin:$PATH

3.2.2 Windows下設定環境變數

Windows如何修改系統環境變數，以及修改環境變數PATH，請參考網上教程（[百度](https://www.baidu.com/s?wd=Windows 修改系統環境變數 PATH) 或 Google），

將對應變數設定到系統環境變數中：

將go/bin和生成的可執行檔案的路徑添加到Path：

這樣go相關的命令以及編譯包生成的路徑都是全域可以找到的，不需要指定命令的絕對路徑就可以執行，

3.3 IDE工具配置

本文以Goland開發工具為基礎，介紹在該IDE下的常用工具配置，

常用的工具包括：

1. go fmt : 統一的代碼格式化工具（必須），
2. golangci-lint : 靜態代碼質量檢測工具，用于包的質量分析（推薦），
3. goimports : 自動import依賴包工具（可選），
4. golint : 代碼規范檢測，并且也檢測單檔案的代碼質量，比較出名的Go質量評估站點Go Report在使用（可選），

3.3.1 go fmt, goimports, golangci-lint的配置

由于這三個工具是Goland自帶的，因此配置比較簡單，參考以下圖文操作示例：

1. 在Goland的設定中，選擇Tools - File Watchers，隨后選擇添加

2. 依次點擊添加這3個工具，使用默認的配置即可

   如果程式飄紅的話可能是對應程式未安裝成功，一般giimports和golangci-lint會出現這個情況，

   如果一直下載不成功的話則可以去網頁上下載下來之后放到專案目錄中然后在對應目錄下使用go install安裝即可，默認會安裝到bin目錄下，所以前面path設定正常的話就可以找到對應的程式了（沒有安裝成功的話程式位置的程式是飄紅的）：

我通過everything搜索到的兩個工具的路徑如下，你也可以嘗試搜索一下到對應目錄下執行go install進行安裝：

/d/mynotes/go/src/github.com/golangci/golangci-lint/cmd/golangci-lint

/d/mynotes/go/pkg/mod/golang.org/x/tools@v0.1.0/cmd/goimports

之后記得設定為全域級別（避免每個專案都重新下載設定）：

3. 隨后在擼代碼的程序中保存代碼檔案時將會自動觸發這3個工具的自動檢測，

3.3.2 golint工具的安裝及配置

由于Goland沒有自帶golint工具，因此首先要自己去下載安裝該工具，（所以上面兩個插件如果GoLand本身一直下載或者安裝失敗的話就是按照這樣的方式處理即可，命令列下載不成功直接從網頁上下載復制到對應位置也行）

使用以下命令安裝：

mkdir -p $GOPATH/src/golang.org/x/

cd $GOPATH/src/golang.org/x/
git clone https://github.com/golang/lint.git
git clone https://github.com/golang/tools.git

cd $GOPATH/src/golang.org/x/lint/golint
go install

安裝成功之后將會在$GOPATH/bin目錄下看到自動生成了golint二進制工具檔案（像fmt工具默認是在go安裝目錄的bin目錄下，不是在$GOROOT/bin下），

3.3.3 golint配置

• 隨后在Goland的Tools - File Watchers配置下，通過復制go fmt的配置

復制go fmt內容之后進行修改：

• 修改Name, Program, Arguments三項配置，其中Arguments需要加上-set_exit_status引數，如圖所示：

• 保存即可，隨后在代碼撰寫中執行保存操作時將會自動觸發golint工具檢測，

設定全域后到其它專案中只需要開啟對應工具即可，

3.3.4 配置備份匯入

也可以通過保存以下XML組態檔內容，使用import匯入功能即可完成配置（golint還是得自己安裝），

檔案內容（下面的內容是我從我的配置中匯出的）：

<TaskOptions>
  <TaskOptions>
    <option name="arguments" value="-set_exit_status $FilePath$" />
    <option name="checkSyntaxErrors" value="true" />
    <option name="description" />
    <option name="exitCodeBehavior" value="ERROR" />
    <option name="fileExtension" value="go" />
    <option name="immediateSync" value="false" />
    <option name="name" value="golint" />
    <option name="output" value="$FilePath$" />
    <option name="outputFilters">
      <array />
    </option>
    <option name="outputFromStdout" value="false" />
    <option name="program" value="golint" />
    <option name="runOnExternalChanges" value="false" />
    <option name="scopeName" value="Project Files" />
    <option name="trackOnlyRoot" value="true" />
    <option name="workingDir" value="$ProjectFileDir$" />
    <envs>
      <env name="GOROOT" value="$GOROOT$" />
      <env name="GOPATH" value="$GOPATH$" />
      <env name="PATH" value="$GoBinDirs$" />
    </envs>
  </TaskOptions>
  <TaskOptions>
    <option name="arguments" value="fmt $FilePath$" />
    <option name="checkSyntaxErrors" value="true" />
    <option name="description" />
    <option name="exitCodeBehavior" value="ERROR" />
    <option name="fileExtension" value="go" />
    <option name="immediateSync" value="false" />
    <option name="name" value="go fmt" />
    <option name="output" value="$FilePath$" />
    <option name="outputFilters">
      <array />
    </option>
    <option name="outputFromStdout" value="false" />
    <option name="program" value="$GoExecPath$" />
    <option name="runOnExternalChanges" value="false" />
    <option name="scopeName" value="Project Files" />
    <option name="trackOnlyRoot" value="true" />
    <option name="workingDir" value="$ProjectFileDir$" />
    <envs>
      <env name="GOROOT" value="$GOROOT$" />
      <env name="GOPATH" value="$GOPATH$" />
      <env name="PATH" value="$GoBinDirs$" />
    </envs>
  </TaskOptions>
  <TaskOptions>
    <option name="arguments" value="-w $FilePath$" />
    <option name="checkSyntaxErrors" value="true" />
    <option name="description" />
    <option name="exitCodeBehavior" value="ERROR" />
    <option name="fileExtension" value="go" />
    <option name="immediateSync" value="false" />
    <option name="name" value="goimports" />
    <option name="output" value="$FilePath$" />
    <option name="outputFilters">
      <array />
    </option>
    <option name="outputFromStdout" value="false" />
    <option name="program" value="goimports.exe" />
    <option name="runOnExternalChanges" value="false" />
    <option name="scopeName" value="Project Files" />
    <option name="trackOnlyRoot" value="true" />
    <option name="workingDir" value="$ProjectFileDir$" />
    <envs>
      <env name="GOROOT" value="$GOROOT$" />
      <env name="GOPATH" value="$GOPATH$" />
      <env name="PATH" value="$GoBinDirs$" />
    </envs>
  </TaskOptions>
  <TaskOptions>
    <option name="arguments" value="run --disable=typecheck $FileDir$" />
    <option name="checkSyntaxErrors" value="true" />
    <option name="description" />
    <option name="exitCodeBehavior" value="ERROR" />
    <option name="fileExtension" value="go" />
    <option name="immediateSync" value="false" />
    <option name="name" value="golangci-lint" />
    <option name="output" value="" />
    <option name="outputFilters">
      <array />
    </option>
    <option name="outputFromStdout" value="false" />
    <option name="program" value="golangci-lint.exe" />
    <option name="runOnExternalChanges" value="false" />
    <option name="scopeName" value="Project Files" />
    <option name="trackOnlyRoot" value="true" />
    <option name="workingDir" value="$ProjectFileDir$" />
    <envs>
      <env name="GOROOT" value="$GOROOT$" />
      <env name="GOPATH" value="$GOPATH$" />
      <env name="PATH" value="$GoBinDirs$" />
    </envs>
  </TaskOptions>
</TaskOptions>

4. 私有依賴管理

版本選擇演算法

當專案中存在同一個第三方包依賴，并且依賴版本不一致時，Go Modules使用的“最小版本選擇演算法”(The minimal version selection algorithm: https://github.com/golang/go/wiki/Modules#version-selection )，

例如，如果您的模塊依賴于具有require D v1.0.0的模塊A，并且您的模塊還依賴于具有require D v1.1.1的模塊B，則最小版本選擇將會選擇D的v1.1.1版本用以構建（使用最高版本），

請不要問我為什么這個演算法名字叫“最小版本選擇演算法”，然而內容卻是“最高版本選擇演算法”，若有糾結于此的同學歡迎向官方提issue：https://github.com/golang/go/issues

私有依賴管理

如果你可以通過go.mod完美地管理當前的專案包依賴，那么可以忽略該章節，如果你在處理專案的包依賴管理中遇到了問題，那么建議你繼續閱讀該章節，可以找到解決問題的靈感，

前面章節我們非常詳細、圖文并茂地介紹了基本的開發環境安裝/配置、Go Module安裝使用，在實際的專案開發中，你會發現更多的問題，常見的：

1. 雖然GF足夠強大，但多數時候依賴的包不僅僅是GF，還包括一些額外的第三方包，特別是golang.org的包，需要自帶梯子翻墻下載，即使本地方便處理，但是在自動部署系統上可能會稍麻煩；
2. 一些自研開發的第三方包，特別是一些業務依賴包，是不允許公開下載的（私有庫），并且版本庫也可能不支持HTTPS協議，因此無法使用go get或者go.mod進行下載和管理；
3. 等等；

如果你遇到了上面所提到的問題，我們建議的解決方案：通過GOPRIVATE的方式設定私有包有效域名，

例如以下命令列方式：

export GOPROXY=https://goproxy.cn
export GOPRIVATE=git.xxx.com
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o main main.go

該特性需要Go v1.13以上版本支持，

在Goland中這么設定：

這類問題之前也總結過一部分，go module使用本地包以及本地包上傳gitlab使用正好和這里對應起來了：https://blog.csdn.net/weixin_39510813/article/details/116499970

5. 最后

使用Go開發的一大好處就是應用符合云原生的要求，各個行程以微服務的形式存在（感覺像是對模塊化編程的升級，讓這些通用功能模塊上云），之間通過gRPC的方式進行，保證各個行程間的耦合盡可能的低，這樣可以根據需求增刪部分行程而互不影響，再利用docker對環境和應用容器化，這樣可以快速部署在不同設備，這樣才有可能做到快速并自動化的進行設備更換和應用部署，物聯網的基礎打好了才有更準確的資料進行大資料處理，也才有更準確的資料進行云計算，也才能由足夠的資料對AI進行訓練，也才有可能以此完成AI的倍訓，由AI自己進行資料生產、采集、維護、計算處理和學習訓練，而不是由人工進行資料采集、維護、計算進而“投喂”給AI進行訓練，如果把人工訓練的AI類比人的小時候的話，那么擁有自主資料采集、計算和訓練學習的AI才是真的長大了，因為他有了自己認識世界并獨立生存和生活的能力（物聯網、大資料、云計算、AI這些都是相輔相成的；一些機器人的中臺也基本都會通過Go來開發，如果Go解決了驅動開發的制約的話那么機器人開發可能也會變得更加成熟），