document.writeln('');
必須匹配架構與發行版:uname -m為aarch64/arm64時需下載linux-arm64.tar.gz,而非amd64包;/etc/os-release確認發行版后,Alpine須源碼編譯,Ubuntu/CentOS等用官方tar.gz并正確配置GOROOT、PATH、GOPATH及GOPROXY。

直接在 ARM 實例(如 AWS Graviton、騰訊云 TKE ARM 節點)上下載 go1.22.5.linux-amd64.tar.gz,會導致 bash: /usr/local/go/bin/go: cannot execute binary file: Exec format error。這不是權限問題,而是 CPU 指令集不兼容。
uname -m 查架構:輸出 x86_64 → 對應 amd64;輸出 aarch64 或 arm64 → 選 arm64 包cat /etc/os-release 確認發行版:Ubuntu/CentOS/Debian 可直接用官方 tar.gz;Alpine 不支持 glibc,必須源碼編譯或換鏡像apt install golang 或 yum install golang:Ubuntu 22.04 默認裝的是 Go 1.18,缺 go work 和完整 go mod 支持,且路徑常為 /usr/lib/go,和 $GOROOT 探測邏輯沖突sudo tar -C /usr/local -xzf go1.22.5.linux-amd64.tar.gz 只是把文件放對位置,不配置環境變量,go 命令仍不可用,go install 生成的二進制也找不到。
~/.bashrc 或 /etc/profile.d/golang.sh 中寫死三行:export GOROOT=/usr/local/goexport GOPATH=$HOME/goexport PATH=$GOROOT/bin:$GOPATH/bin:$PATHPATH 順序很重要:必須把 $GOROOT/bin 放最前,否則系統可能優先調用舊版 /usr/bin/gogo env GOPATH 輸出應為 $HOME/go,不是空值或 /root/go(多用戶時尤其注意)不設代理時,go mod download 默認連 proxy.golang.org 和 sum.golang.org,超時后重試 3 次才報錯,看起來像“命令沒反應”。更隱蔽的是校驗失敗:verifying github.com/gorilla/mux@v1.8.0: checksum mismatch,實際是校驗服務器不可達導致本地緩存被跳過。
go env -w GOPROXY=https://mirrors.tuna.tsinghua.edu.cn/goproxy/,directgo env -w GOSUMDB=offGOSUMDB=off,改用可信代理鏈:go env -w GOPROXY=https://goproxy.cn,directgo env -w GOSUMDB=sum.golang.org(需確保代理能轉發校驗請求)go env -w GOPRIVATE=git.internal.example.com,否則會被代理攔截go run main.go 在云服務器上跑一次就完事,進程沒管理、日志不落盤、崩潰不重啟,還容易殘留臨時編譯產物。它只適合本地驗證邏輯,不是部署手段。
立即學習“go語言免費學習筆記(深入)”;
CGO_ENABLED=0 go build -a -ldflags -s -w -o myapp ./cmd/serverCGO_ENABLED=0 確保無 libc 依賴,-s -w 去符號表減體積/etc/systemd/system/myapp.service,指定 User=www-data、Restart=always、StandardOutput=journal8080),關掉 22 的公網暴露——用跳板機或堡壘機 SSH,別讓 root 直通公網go env -w 寫入的 $HOME/go/env 是純文本,沒有權限隔離;某人誤執行 sudo go env -w GOROOT=/wrong/path,后續所有 su 切換用戶都會繼承這個錯誤值,且優先級高于 shell export,排查起來極難定位。