Linux 安裝配置 Go 語言開發環境完整指南

Go (Golang) 以簡潔語法、高併發效能、靜態編譯部署優勢，成為雲原生、微服務、CLI 工具開發首選。本文提供 Linux (RHEL/CentOS/Ubuntu/Debian) 上 Go 開發環境的標準化安裝、配置、版本管理、IDE 整合與專案初始化全流程。

安裝方式選擇

方式一：官方二進制包標準安裝 (推薦生產)

1. 下載：

   # 訪問 https://go.dev/dl/ 獲取最新版連結
   VERSION=1.22.3
   wget https://go.dev/dl/go${VERSION}.linux-amd64.tar.gz

2. 驗證校驗和 (可選)：

   sha256sum go${VERSION}.linux-amd64.tar.gz
   # 對照官網 SHA256

3. 安裝到 /usr/local：

   sudo rm -rf /usr/local/go
   sudo tar -C /usr/local -xzf go${VERSION}.linux-amd64.tar.gz

4. 配置環境變數： 編輯 /etc/profile.d/go.sh (系統級) 或 ~/.bashrc (使用者級)：

   export GOROOT=/usr/local/go
   export GOPATH=$HOME/go
   export PATH=$GOROOT/bin:$GOPATH/bin:$PATH

5. 生效並驗證：

   source /etc/profile.d/go.sh
   go version
   # go version go1.22.3 linux/amd64

方式二：使用 gvm 多版本管理 (開發機推薦)

# 安裝依賴
sudo apt install bison make gcc curl git  # Ubuntu
# sudo dnf install bison make gcc curl git # RHEL

# 安裝 gvm
bash < <(curl -s -S -L https://raw.githubusercontent.com/moovweb/gvm/master/binscripts/gvm-installer)
source ~/.gvm/scripts/gvm

# 安裝並使用特定版本
gvm install go1.22.3 -B
gvm use go1.22.3 --default

Go Modules 專案初始化 (現代標準)

Go 1.11+ 推薦啟用 Modules 模式 (GO111MODULE=on，Go 1.16+ 預設開啟)。

1. 建立專案：

   mkdir -p ~/go/src/myproject
   cd ~/go/src/myproject
   go mod init github.com/username/myproject

2. 目錄結構：

   myproject/
   ├── go.mod          # 模組定義與依賴
   ├── go.sum          # 依賴校驗和
   ├── main.go         # 入口
   ├── pkg/            # 內部包
   │   └── utils/
   └── cmd/            # 多入口專案
       └── server/

3. 常用模組命令：

   go mod tidy           # 整理依賴 (增刪)
   go mod vendor         # 複製依賴到 vendor/ (離線構建)
   go list -m all        # 列出所有依賴
   go get -u ./...       # 升級所有依賴

開發工具鏈配置

IDE/編輯器整合

• VS Code + Go 官方擴充： 安裝 golang.go，自動提示安裝 gopls、dlv，開箱即用。
• GoLand (JetBrains)： 內建完整 Go 支援，專業開發首選，需授權。
• Vim/Neovim： vim-go + coc.nvim + gopls。

交叉編譯與部署

# Linux 編譯 Windows 64位
GOOS=windows GOARCH=amd64 go build -o myapp.exe .

# Linux 編譯 Linux ARM64 (樹莓派/雲伺服器)
GOOS=linux GOARCH=arm64 go build -o myapp .

# 靜態編譯 (無 libc 依賴，適合 scratch 容器)
CGO_ENABLED=0 GOOS=linux go build -a -installsuffix cgo -o myapp .

常見問題速查

完成上述配置，即擁有專業級 Go 開發環境，支援現代模組化開發、高效除錯、靜態分析與跨平台部署。