golang基礎教學

下載

途徑一: choco

如果您想要choco可以參考:

請參考: 套件安裝-常用安裝項目-golang

途徑二: 官方下載zip檔案

另一個是直接從官方下載: https://golang.org/dl/

選擇zip (Kind: Archive)的下載即可。(不要選Kind: Source，這個沒有bin的資料夾)

完畢之後看您要把解壓縮的檔案放到哪邊去，我會建議放到

%ProgramFiles%\Go\1.16.2

即在%ProgramFiles%建立一個Go的資料夾，裡面可以放很多版本的Go(假設您有特殊的需求需要裝很多版本的go)

同時這個路徑也是GOROOT的路徑

然後新增一個GOPATH的路徑，這個路徑是屬於放自己SOURCE的地方

我建議放在

%USERPROFILE%\go\1.16.2

在這個資料中，要新增

• bin
• pkg
• src

等三個資料夾

總結

• GOPATH: %USERPROFILE%\go\1.16.2

  • bin: 建議把這個資料夾也加入到PATH的環境變數去，因為go install都會跑到這邊來，為了cmd可以直接不需要cd切換，會建議加上此路徑
  • pkg
  • src

• GOROOT: %ProgramFiles%\Go\1.16.2

  這個也是golang的IDE設置go SDK的位置

  • 要在您的PATH環境中告知go.exe的位置，所以要加上這個 %ProgramFiles%\Go\1.16.2\bin

🔔 如果將來您想要升級golang的版本，可以只下載新版的Go，

接著改GOROOT，GOPATH照舊即可。

其他相關資料

• 多個golang安裝

IDE

要先完成下載

Neovim

如果您用的是Neovim使用的安裝方式應該為vim-plug

Plug ‘fatih/vim-go’, { ‘do’: ‘:GoUpdateBinaries’ }

完成之後使用指令:

:GoInstallBinaries

他會開始幫你裝很多東西，這些指令等同您直接用go get是一樣的意思，只是他幫你統一包裝好，省的您去go get很多東西

以下就是他會幫您裝上的東西:

安裝 Go

👆 這是另外的參考資料有興趣可以看看(如果您不是windows的在看，是windows的照我上面的弄就好了)

教學

環境變數

GO111MODULE=auto
GOPATH=C:\Users\your-name\go
GOROOT=C:\Go\
Path=...;%GOPATH%\bin

GOPATH

從 go 1.8 開始，GOPATH 環境變數現在有一個預設值，如果它沒有被設定，他的預設值在這些系統分別是這樣設定:

• Unix: $HOME/go

• Windows%USERPROFILE%/go

  ❗ 不建議用%USERPROFILE%，在windows中有的程式會抓成 C:\WINDOWS\system32\config\systemprofile

以下我只談Windows的設定:

如果您要設定GOPATH，就建立一個新的環境變數，名稱為GOPATH

GOPATH可以允許多個目錄，用分隔號隔開即可(LINUX是冒號)

值得一提的是如果有多個GOPATH時，預設會將go get放在第一個目錄下

GOPATH結構

• src: 放原始碼(例如:.go, .c, .h, .s等)
• pkg: 編譯後產生的檔案(如: .a)
• bin: 編譯後產生出來的可執行檔案。

  📙 可以考慮也把這個Path加入到環境變數之中，方便直接就用cmd來執行

CLI命令

go help xxx 查看幫助

go-build.bat

打包所選資料夾中所有的go檔案成執行檔

@echo off
echo Input the directory where your source file(xxx.go) exists
set /P "inputGoPath=:"
cd %inputGoPath%
REM echo %cd%

for %%A in (*.go,) do (
    REM go build -o output.exe input.go
    go build %%A
)
REM cd %~dp0  REM 在CD回來是個好習慣
echo done! && pause > nul
EXIT /B

以下這個也是打包go，但是不用任何輸入，

我會把以下這個.bat檔案放到%GOPATH%/bin底下

其實只要任何PATH包含在內的資料夾在內都可以，

這樣當我們呼叫go-build.bat就能執行，

@echo off
REM cd %cd% 不需要，預設就是用工作路徑而不是%~dp0

for %%A in (*.go,) do (
    go build %%A
    echo done: %%A
)

其實以上的bat檔案也不一定要寫，go build --help:

go build [-o output] [build flags] [packages]

其實所有的選項都是可選項，這表示您可以直接go build即可，

預設他會抓取您當前工作路徑的main包進行打包。

batch color參考

gofmt and go fmt

如果您本身是使用fatih/vim-go在保存文件的時候他就會把go的代碼給代碼自動格式化，所以基本上不用管他。

他的實現應該和以下的行為是類似的

augroup xxx
    au!
    au BufLeave *.go normal! mG
augroup END

以上的用法是指當離開副檔名為go的文件時，自動把該檔案加入倒mark為G的名稱之中

gofmt: 格式化。 go fmt: 等同 gofmt -l -w (-w會直接把格式化的結果寫到檔案去)

❗ golang的縮排預設是使用tab，這點我個人是不喜歡，不過既然人家的標準就已經這樣定，就遵守吧

.editorconfig

[*.go]
indent_style = tab

總之不管您是有哪個IDE，理論上都會有支持自動格式化的東西，尤其go又特別搞出一個fmt，代表他希望統一標準

所以，要不就是您自己需要手動設置一次之後就一勞永逸(JetBrains出版的Goland.fmt )，不然就是他已經幫您設定好了，連動都不用

程式相關

go run, go install

go run: 「編譯」+ 「執行」(本身需要是可執行的package才行)

go install: 編譯成二進位執行檔 或 包存檔(.a)

• go run xxx.go // 可以直接運行

• go run –work xxx.go

  加上–work會把他生成出來的東西(含執行檔)的資料夾告訴您，例如:

  WORK=C:\Users\xxx\AppData\Local\Temp\go-build284910950
  

編譯

編譯並產生執行檔，此執行檔位於當前的工作目錄中

• go build compile packages and dependencies

• go build -o bin/main.exe src/main/main.go

  📙 所有的路徑都是相對於您的工作路徑，如果目錄資料夾不存在會新增。

  📙 忽略-o會直接在當前的路徑下產生與.go同名的執行檔

  go build xxx.go

正式的流程

• gosetup-root: GOROOT=C:\Go
• gosetup-gopath: GOPATH=%userprofile%\go
• build: %GOROOT%\bin\go.exe build -o %userprofile%\AppData\Local\Temp\___1go_build_hello_world_go.exe %userprofile%\go\src\tutorial\hello_world.go
• run exe: ```%userprofile%\AppData\Local\Temp___1go_build_hello_world_go.exe``

小節:

1. GOROOT: go.exe的路徑

2. GOPATH\

3. go.exe -o output_exe_path src_go_path

   此步驟完成會把執行檔放到output_exe_path中

4. 執行打包出來的執行檔 (output_exe_path)

Go程式執行順序

go run *.go
├── 被執行的主包
├── 初始化所有被匯入的包 (執行init函數，init函數在一個檔案裡面可以有多個，但是會按造順序來執行)
|  ├── 初始化所有被匯入的包 ( 遞迴定義 )
|  ├── 初始化所有全域性變數
|  └── INIt 函式以字母序被呼叫
└── 初始化主包
├── 初始化所有全域性變數
└── INIt 函式以字母序被呼叫

❗ 最需要記住的是， 每個包只初始化一次被匯入的包

golang中的簡單函數介紹

fmt.Print, Println, Printf 差異

他們全部都是輸出結果

go packages

官方的文檔其實不錯，可以直接到官方文檔查看: go packages

Go的關鍵字

總共有25個

break    default      func    interface    select
case     defer        go      map          struct
chan     else         goto    package      switch
const    fallthrough  if      range        type
continue for          import  return       var

• fallthrough: 用來在switch case中繼續向下執行

附檔名介紹

• .a (package archive):

  在您的package中只要不是main，

  在執行完go install <Package(專案資料夾(相對於gopath)路徑)>

  📙 所謂的 package就是%gopath%/src下的第一層子目錄

  他會生成在%GOPATH%/pkg/<OS_Arch> (例如: %GOPATH%/pkg/windows_amd64)

  ❗ 要打包到%GOPATH%/pkg/<OS_Arch>須滿足兩點

  1. 有其他檔案他不是package main
  2. 在此package中沒有任何一個檔案中有main的宣告

  這種package我們稱之為「應用包」。主要用來讓執行包來導入，節省再編譯的時間

• .exe: 可執行包(package)

安裝godoc

go doc和godoc是不同的東西

go doc把東西印在console上，很醜，大概也沒幾個人願意這樣看

godoc可以向網頁一樣顯示文件資訊

但從go 1.12之後godoc移除不再是您安裝完go就自帶的執行檔，

但是您還是可以套過

go get -u -v golang.org/x/tools/cmd/godoc

• -u 更新 連同 相依套件也會一併更新 (一般的go get只會抓取遺失的檔案並不會去更新，所以要更新就用-u)
• -v 會顯示詳細資料(安裝下載的過程，會在console告訴您，我個人是建議加上)

來獲取。

接下來

godoc -http=127.0.0.1:6060 -play

(play是可以利用它當作編輯器也能運行，測試用的)

或

godoc -http=:6060 -play

(埠號不一定要6060看您高興)

或更省，直接

godoc

預設埠號是6060

您就可以直接看官方的文檔的離線版本，但看官方文件除非沒網路，不然直接去官網看就好了😆

我們有興趣的其實是看自己的文件

godoc -goroot=C:\Users\xxx\go\

(放您gopath的路徑)

然後您就可以上

http://127.0.0.1:6060/

看到自己的文檔了

❗ 他產生的文檔不包含package main的檔案

📙 godoc還可以對外公佈，所以不是只有自爽而已，有時間我會再補

go get & go clean

go get: 在GO111MODULE=on時會載到 (pkg/mod)

%GOPATH%/pkg/mod/github.com/auth/repName

而如果不使用module，則會載到 (src)

%GOPATH%/src/github.com/auth/repName

• go get -u -v golang.org/x/tools/cmd/godoc

  • -u 更新 連同 相依套件也會一併更新 (一般的go get只會抓取遺失的檔案並不會去更新，所以要更新就用-u)
  • -v 顯示詳細資訊
  • -d The -d flag instructs get not to build or install packages

  範例:

  require github.com/stretchr/testify v1.7.0 指定版本 go get github.com/stretchr/testify@v1.7.0

• go clean -i -n golang.org/x/tools/cmd/godoc

  • -i 移除二進位的執行檔
  • -n 不會真的移除讓您知道有那些東西會被移除

go mod why -m

go mod why -m github.com/yofu/dxf

可以知道為什麼mod會需要這個套件，

假設您從別人的專案自己fork一份到您的github之中，

但是如果人家裡頭有寫

import (
	"github.com/yofu/dxf"
)

那麼即便您fork了，當下不可能把原本的code中的名稱也跟著更改，

您馬上fork完只能在pkg.go.dev 看到您複製的項目。(搜尋您自己的名稱)

因此正常來說不能只接用fork就想佔為己用，這也是不道德的，當然如果您是考量到該專案有可能被作者刪除，是可以複製一份，

萬一作者真的刪除再從source code把各項名稱(“github.com/yofu/dxf”)改成自己的名稱即可再用。

go env指令

你可能會覺得很煩一下要設定GO111MODULE, GOROOT, GOPATH, GOPROXY, GOPRIVATE, GOTMPDIR…各種環境變數很煩

好的！你可以在系統上加這些環境變數，那他會以系統的為主。

而如果妳希望用一個簡單的命令就能更改這些變數，go env誕生了！

go env

當您執行完之後可以看到現在go上的所有環境變數的設定，你就會了解這些變數目前您用的是什麼

接下來如果你想要寫入，可以這麼做

這麼一來就能直接寫入到GOPROXY中去了

您可能會好奇，go env -w如果不是直接改系統變數，那他這些數值是保存在哪邊？ (可以參考👉Where are the golang environment variables stored?)

go env GOENV

其實你用go env看也是可以，只是go env會全部都列出來，你要慢慢找…

go env後面接上您想要看到的環境變數即可列出該變數！

⚠ 最後提醒您！

如果您的系統變數已經有設定了，他會以系統變數為主。

即go env先看系統變數有系統變數就用它，沒有了話才去看env的檔案內容。

GOPROXY是什麼？

在go的世界，當我們要導入其他模塊，可以很方便的從知名的VCS¹中導入

舉例一些VCS的提供方:

• Github
• Bitbucket
• SVN (Subversion)
• Bazaar
• Fossil
• Mercurial

↑參考資料

考慮一種情況，如果作者對當前版本做修改，或者直接把專案刪除，那麼您的專案又該怎麼辦?

也許你會說當你一開始做這件事時已經會下載一份到%GOPATH%\pkg\mod，了不起再把那個資料夾複製到您要的電腦就好了…

這很麻煩，而且也不適用在你以外的其他人身上。

因此在Go 1.13開始，Go Module成為了Golang的標準包管理器，在安裝的時候會自動作用，並且有一個環境變數GOPROXY，可以對它影響。

那GOPROXY就是一個代理，所有的VCS都能送一份副本至GOPROXY，那麼即便最後作者在自己的VCS中把該專案刪除，GOPROXY還是能抓的到不受影響，

也就是說GOPROXY可以簡單的理解成，一個共用庫統一管理大家的程式碼。

而GOPROXY也有很多，例如:

• https://gocenter.io
• https://goproxy.cn

  中國大陸沒有辦法訪問: https://proxy.golang.org ，所以https://goproxy.cn對中國很有用。

  • 👉 參考資料一: 干货满满的 Go Modules 和 goproxy.cn
  • 👉 參考資料二

而當然如果您有一些私有的項目，不能丟到gocenter，可以在設置GOPRIVATE，例如

GOPRIVATE=*.internal.mycompany.com

go env -w GOPRIVATE=*.corp.example.com,github.com/org_private

讓一些項目可以從Private VCS Repos中來下載，有興趣請在自己去研究GOPRIVATE…以下我們還是把精力放在GOPROXY

官方提供考靠的GOPROXY

• proxy.golang.org

  ❗ proxy.golang.org does not save all modules forever. 在一些特殊情況下模塊可能不會被永久保存

• sum.golang.org
• index.golang.org

如果你不想要用GOPROXY想要直接從VCS導入，那您可以設定:

GOPROXY=direct

表明您要直接的從VCS來下載

當然GOPROXY可以同時設定很多個，用「,」隔開就好了，例如:

GOPROXY=https://proxy.golang.org,direct

以上的詳細資訊，如果有興趣深入研究再請參考

GOPROXY下載通常速度都比直接從VCS要快得多！

Go的坑

Value and Reference

傳值的型別有:

• int系列
• float系列
• bool
• string
• array
• struct

引用的型別有:

• pointer
• slice
• map
• channel
• func
• interface

參考資料

• https://www.mdeditor.tw/pl/2J1M/zh-tw
• https://www.mdeditor.tw/pl/gdPL/zh-tw