Go 常用命令全景速查：build、run、test、mod、vet、pprof 實戰參數詳解
Go 工具鏈以「開箱即用、約定優於配置」著稱，go 命令涵蓋構建、測試、依賴管理、性能分析、代碼診斷全生命周期。本文系統整理高頻命令與實戰參數，作為 Go 開發者的「桌面速查卡」。
一、 go build：構建與交叉編譯
| 命令/參數 | 作用 | 實戰示例 |
|---|
go build | 編譯當前包，非 main 包不產出文件 | 驗證語法錯誤 |
go build -o myapp | 指定輸出二進制名稱 | go build -o bin/server ./cmd/server |
go build -ldflags="-s -w" | 去除符號表與 DWARF 調試信息，減小體積 20-30% | 生產構建必加 |
GOOS=linux GOARCH=amd64 go build | 交叉編譯 (環境變量法) | Mac/Linux 編譯 Windows: GOOS=windows GOARCH=amd64 go build -o app.exe |
go build -tags="json1 omitempty" | 編譯標籤控制條件編譯 | 區分企業版/社區版功能 |
go build -race | 啟用競態檢測器 | 測試環境排查 Data Race |
go build -trimpath | 移除編譯路徑信息，實現可復現構建 | Go 1.13+ 推薦 |
文件名後綴自動匹配規則
go run main.go # 單文件
go run ./cmd/server # main 包目錄
go run -race ./... # 競態檢測運行整個項目
go run -mod=vendor main.go # 使用 vendor 目錄依賴
三、 go test：測試與覆蓋率
| 命令 | 說明 |
|---|
go test ./... | 遞歸運行所有包測試 |
go test -v | 輸出詳細日誌 (PASS/FAIL/RUN) |
go test -run TestLogin | 正則匹配運行特定測試函數 |
go test -bench=. -benchmem | 運行基準測試並顯示內存分配 |
go test -cover | 顯示代碼覆蓋率 |
go test -coverprofile=cover.out | 生成覆蓋率數據文件 |
go tool cover -html=cover.out | 瀏覽器打開覆蓋率熱力圖 |
go test -count=3 | 重複運行 N 次 (排查測試不穩定) |
go test -timeout=30s | 設置單個測試超時 |
go test -parallel=4 | 並行運行測試函數數量 |
四、 go mod：模塊依賴管理 (Go 1.11+)
| 工具 | 命令 | 核心價值 |
|---|
| go vet | go vet ./... | 檢測可疑結構：Printf 格式錯誤、無用賦值、鎖拷貝、未檢查錯誤等，**CI 必跑** |
| gofmt | gofmt -w . | 官方格式化工具，-w 寫回文件，IDE 保存自動調用，**統一團隊代碼風格** |
| golangci-lint | golangci-lint run | 聚合 50+ linter (staticcheck, gosec, revive...)，比 vet 全面，**推薦替代 golint** |
| goimports | goimports -w . | gofmt + 自動增減 import，**IDE 保存推薦調用** |
六、 go doc / godoc：文檔查看
# CPU Profile (運行中程序)
go tool pprof https://localhost:6060/debug/pprof/profile?seconds=30
# Heap Profile
go tool pprof https://localhost:6060/debug/pprof/heap
# Goroutine Profile (排查泄漏)
go tool pprof https://localhost:6060/debug/pprof/goroutine
# 從文件分析
go tool pprof cpu.prof
2. 交互式分析命令
| 命令 | 作用 |
|---|
top10 | 顯示佔用前 10 的函數 |
web | 生成 SVG 火焰圖並在瀏覽器打開 (需 Graphviz) |
list main.func | 顯示函數源碼級熱點 |
peek main.func | 顯示調用者/被調用者關係 |
traces | 顯示 Goroutine 創建堆棧 (需 trace profile) |
八、 go tool trace：Goroutine 執行軌跡可視化
| 變量 | 默認值 | 作用 |
|---|
GOPROXY | https://proxy.golang.org,direct | 模塊代理，國內推薦 https://goproxy.cn,direct |
GOSUMDB | sum.golang.org | 校驗和數據庫，國內可關閉 off |
GOFLAGS | - | 默認參數，如 -mod=vendor |
GOGC | 100 | GC 觸發閾值，調大減少 GC 頻率 |
GOTRACEBACK | single | panic 堆棧詳盡度：all 顯示所有 G |
十、 避坑清單
- go build 不指定 -o → 輸出文件名不可控，腳本部署失敗
- go get -u 升級主版本 → 破壞兼容性，**鎖定版本或用 go.mod 管理**
- vendor 目錄未提交 → 離線構建/容器構建失敗
- 忽略 go vet 告警 → 線上 Printf 格式錯誤導致 panic
- pprof 端口暴露公網 → 信息洩露，**僅內網/側車訪問**
- 交叉編譯 CGO_ENABLED=1 → 需目標平台工具鏈，**純 Go 設置 CGO_ENABLED=0**
熟練掌握 go build/run/test/mod/vet/pprof/trace 核心命令與高頻參數，配合 GOPROXY=goproxy.cn 國內加速、golangci-lint 靜態檢查、go tool pprof/web 可視化分析，讓 Go 開發從「會用命令」進化為「駕馭工具鏈」。
