先执行 go version 确认已安装且版本≥1.20，再用 go mod init 初始化模块，接着 go run main.go 验证基础流程，最后配置 GOproxy=https://goproxy.cn,direct 解决国内依赖拉取问题。
确认系统是否已安装 Go 及版本是否合规
很多新手以为装了 Go 就万事大吉，结果 go run main.go 报错：command not found: go，或运行时提示 Go version too old。本质是环境变量没生效，或安装包不完整。
- 在终端执行
go version，输出应类似go version go1.21.6 darwin/arm64（macOS）或go version go1.21.6 linux/amd64（Linux）；windows 用户注意检查是否用 PowerShell/CMD 而非 git bash（后者可能未继承系统 PATH） - 若提示命令未找到，检查
go是否在$PATH中：echo $PATH（macOS/Linux）或echo %PATH%（Windows），确认包含/usr/local/go/bin（macos/Linux 默认）或C:Gobin（Windows 默认） - Go 1.18+ 才支持泛型，新手项目建议至少用
1.20+；低于此版本请重装，别试图“升级 patch”——Go 不支持就地升级 minor 版本
初始化模块并验证 GOPATH 与 Go Modules 行为
Go 1.16+ 默认启用 GO111MODULE=on，但很多教程仍教你怎么设 GOPATH，导致新手混淆：为什么 go get 不写入 $GOPATH/src？因为 Modules 已绕过它。
- 新建项目目录，进入后立即执行
go mod init example.com/hello（模块名不必真实可解析，但需符合域名格式，避免纯单词如hello） - 此时生成
go.mod文件，内容含module example.com/hello和go 1.21；后续所有go get会把依赖写入该文件，并缓存到本地$GOCACHE（默认~/.cache/go-build），不再触碰$GOPATH - 误删
go.mod后直接go run会报错：go: go.mod file not found in current Directory or any parent；此时不是缺 GOPATH，而是缺模块上下文
快速验证开发流程：从写代码到运行只需三步
别急着配 ide 或调试器。先确保最简链路通：编辑 → 构建 → 运行。中间任何一步失败，都说明环境基础没搭稳。
- 创建
main.go，内容如下：
package main import "fmt" func main() { fmt.Println("Hello, Go!") }- 在同一目录下执行：
go run main.go—— 应立刻输出Hello, Go! - 若报错
cannot find package "fmt"，说明 Go 安装损坏（标准库缺失），必须重装；若报错cannot load fmt，大概率是当前目录不在模块内，补上go mod init xxx - 想生成二进制？执行
go build -o hello main.go，会生成可执行文件hello（macOS/Linux）或hello.exe（Windows）
代理设置不当是新手最常卡住的点
国内用户不配代理，go get 或 go mod download 会卡死或超时，错误信息常是：Get "https://proxy.golang.org/...": dial tcp 142.250.185.113:443: i/o timeout。这不是网络问题，是默认代理不可达。
立即学习“go语言免费学习笔记（深入）”；
- 临时生效（仅当前终端）：
export GOPROXY=https://goproxy.cn,direct（macOS/Linux）或set GOPROXY=https://goproxy.cn,direct（Windows CMD） - 永久生效：写入 shell 配置（如
~/.zshrc）或 Windows 系统环境变量；注意末尾的,direct——它表示对私有模块（如公司内网域名）跳过代理，直连 - 验证是否生效：
go env GOPROXY应输出https://goproxy.cn,direct；再试go get github.com/spf13/cobra@v1.8.0，几秒内完成即成功
代理配置漏掉 ,direct 或写成 https://goproxy.cn/（多斜杠）会导致私有模块拉取失败，这个细节很多人忽略，直到接入公司内部库才暴露。