go环境搭建关键在于三点验证：go version能运行、go mod可正常拉包、go run不报路径或模块错误；需确保path包含$goroot/bin、goproxy配置为国内代理（如goproxy.cn）、项目目录结构符合main包要求且go111module启用。
Go 环境搭建不是“装完就完事”，关键在于 go version 能跑通、go mod 能正常拉包、go run 不报 command not found 或 cannot find module —— 这三点卡住，90% 的新手实际开发会停在第一步。
验证安装后立即检查 GOROOT 和 PATH
很多人执行 go version 成功就以为万事大吉，但后续 go build 报错找不到工具链，或 go install 生成的二进制无法全局调用，根源常是 PATH 没包含 $GOROOT/bin（Windows 是 %GOROOT%\bin）。
-
GOROOT一般由安装程序自动设好，但手动解压 tar.gz 后必须显式设置：比如 Linux 下export GOROOT=/usr/local/go -
PATH必须追加$GOROOT/bin，否则go命令本身能用（因为安装时可能已写入），但子命令如gofmt、gopls会找不到 - macOS / Linux 用户注意：
~/.bash_profile或~/.zshrc修改后必须source，否则新开终端仍无效
go mod 初始化失败时优先查 GOPROXY
在国内，go mod init 或 go get 卡住、超时、返回 proxy.golang.org:443: dial tcp: i/o timeout，基本等于没配代理。
Go 是一个开源的编程语言，它能让构造简单、可靠且高效的软件变得容易。本文给大家带来Go参考手册，需要的可以来下载！ Go是从2007年末由Robert Griesemer, Rob Pike, Ken Thompson主持开发，后来还加入了Ian Lance Taylor, Russ Cox等人，并最终于2009年11月开源，在2012年早些时候发布了Go 1稳定版本。现在Go的开发已经是完全开放的，并且拥有一个活跃的社区。 Go 语言特色 简洁、快速、安全 并行、有趣、开源 内存管理、v数组安全、编译
- 默认
GOPROXY是https://proxy.golang.org,direct，国内无法访问 - 推荐设为
https://goproxy.cn,direct或https://mirrors.cloud.tencent.com/go/,direct - 执行
go env -w GOPROXY=https://goproxy.cn,direct即可生效，无需重启终端 - 如果项目已有
go.mod且依赖私有仓库，需额外加GOINSECURE或配置git凭据，否则go mod download会拒绝连接
区分 go run 和 go build 对目录结构的隐含要求
go run main.go 看似简单，但一旦文件不在当前目录、或包名不是 main、或 import 路径写错，就会报 no Go files in current directory 或 undefined: main.main。
-
go run只接受当前目录下的.go文件，且至少有一个文件声明package main并含func main() -
go build默认构建当前目录，输出可执行文件；若指定路径如go build ./cmd/myapp，则要求该路径下有main包 - 常见误操作：在非项目根目录执行
go run，而go.mod在上层，导致模块解析失败 —— 此时应cd到含go.mod的目录再运行
真正容易被忽略的是：Go 1.16+ 默认启用 GO111MODULE=on，但某些旧脚本或 CI 配置仍硬编码 GO111MODULE=auto，导致本地能跑、CI 报 no required module provides package —— 这类环境差异不打日志、不报明确错误，只静默失败。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
