Go环境3分钟内可搭好并运行最小HTTP服务：先验证go version，正确配置PATH（含$GOROOT/bin和$GOPATH/bin），启用GO111MODULE=on及国内代理，再执行go mod init、go mod tidy、go run main.go运行含/health路由的精简服务。
Go 环境能在 3 分钟内搭好并跑通可提交的最小可运行服务，关键不是装全功能，而是绕过所有默认陷阱。
go version 检查失败？先确认 PATH 和二进制位置
很多人卡在 go version 报“command not found”，其实是 PATH 没生效或安装路径被忽略。macOS / Linux 下常见错误是只改了 ~/.zshrc 却没执行 source ~/.zshrc；Windows 下则常把 C:\Go\bin 和 %GOPATH%\bin 混成一个路径加进 PATH，实际要分两条加。
- 验证是否真安装：直接去安装目录找
go二进制（macOS 在/usr/local/go/bin/go，Windows 在C:\Go\bin\go.exe） - PATH 必须包含两个位置：
$GOROOT/bin（Go 自身命令）和$GOPATH/bin（你go install出来的工具） - 别用
sudo go install—— 权限错乱会导致后续go mod写入失败
GO111MODULE=on 是硬性前提，否则依赖拉不下来
黑客松现场网络不可靠，GO111MODULE=auto 会退化到 GOPATH 模式，而 GOPATH 模式下 go get 默认直连 proxy.golang.org，国内基本超时。必须显式开启模块模式并配代理。
- 执行：
go env -w GO111MODULE=on - 再执行：
go env -w GOPROXY=https://goproxy.cn,direct - 验证：
go env GOPROXY输出应为https://goproxy.cn,direct，不是空或https://proxy.golang.org - 如果项目已有
go.mod但go run报 “cannot find module providing package”，说明模块未初始化 —— 直接删掉go.mod和go.sum，重跑go mod init example.com/hack
一键生成可编译 HTTP 服务模板（含健康检查）
黑客松不写框架、不套中间件，目标是 5 分钟内让 curl http://localhost:8080/health 返回 200。下面这个 main.go 可直接复制粘贴使用：
立即学习“go语言免费学习笔记（深入）”；
package main
import (
"fmt"
"net/http"
"os"
)
func main() {
http.HandleFunc("/health", func(w http.ResponseWriter, r *http.Request) {
fmt.Fprint(w, "ok")
})
http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
fmt.Fprintf(w, "hackathon %s", os.Getenv("VERSION"))
})
fmt.Println("server running on :8080")
http.ListenAndServe(":8080", nil)
}
- 保存后执行：
go mod init hack→go mod tidy→go run main.go - 不需要
go build再运行 ——go run已足够快；若需打包二进制，用go build -ldflags="-s -w" -o server main.go去除调试信息，体积小一半 - 环境变量注入（如
VERSION=v1.0）比硬编码更利于后期 CI/CD 接入，也方便评委快速验证多版本逻辑
真正容易被忽略的点是：黑客松常用共享 WiFi，DNS 不稳定，go mod download 卡住时不要反复重试，先 go env -w GOPROXY=https://goproxy.io,direct 切换备用代理，或者干脆 go mod vendor 把依赖打进本地目录 —— 虽然多一个 vendor/ 文件夹，但能确保离线编译通过。
