go后端开发环境搭建的关键在于模块管理、代理配置和工具链一致性：必须显式开启go111module=on，配置goproxy=https://goproxy.cn,direct以解决国内依赖下载问题，并用go mod init example.com/project规范初始化模块名。
Go 后端开发的环境搭建不是“装完就完事”，关键在于模块管理、代理配置和工具链一致性——这三个点没对齐，后续 go mod 报错、依赖拉不下来、go run 失败会反复出现。
go version 和 GOPATH 已成历史，但 GO111MODULE 必须显式开启
Go 1.16+ 默认启用模块模式，但部分旧脚本或 CI 环境仍可能关闭它。运行 go env -w GO111MODULE=on 是安全底线；否则 go get 会尝试写入 $GOPATH/src，而现代项目根本不需要 GOPATH。
- 验证方式：执行
go env GO111MODULE，输出必须是on - 如果用 IDE（如 VS Code），需确认其终端继承了该设置，否则编辑器内
go mod提示可能失效 - 误设为
auto时，非模块目录下执行go build会静默降级为 GOPATH 模式，导致依赖路径混乱
国内环境下不配 GOPROXY，go mod download 基本卡死
官方 proxy.golang.org 在国内不可达，直接导致 go get github.com/gin-gonic/gin 超时或 403。必须设置国内可信代理：
- 推荐命令：
go env -w GOPROXY=https://goproxy.cn,direct -
direct部分不能省略，否则私有仓库（如公司内网 GitLab）地址会被代理拦截 - 若项目含私有模块，还需额外加
GOINSECURE=git.internal.company.com（替换为实际域名） - 验证：执行
go mod download -x，观察日志是否走goproxy.cn而非直连 GitHub
初始化项目时，go mod init 的模块名不能随便填
模块名不是项目文件夹名，而是未来 import 路径的根。填错会导致后续所有 import 路径失效，且重构成本高：
- 正确做法：用域名反写 + 项目名，例如公司域名为
example.com，项目叫user-service，则执行go mod init example.com/user-service - 错误示例：
go mod init user-service—— 这会让其他服务 import 时写import "user-service/controller"，无法被 Go 工具链解析 - 若已填错，不要删
go.mod重来，应改用go mod edit -module example.com/user-service修正
真正容易被忽略的是：环境变量一旦设错，VS Code 的 Go 插件和终端里的 go 命令可能表现不一致——前者读用户级 go env，后者读 shell 启动时的环境。建议每次新建终端后都跑一遍 go env | grep -E "(GO111MODULE|GOPROXY)" 确认。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
