go环境配置必须用go mod+正确path，禁用gopath模式；go version需≥1.16，path须含go的bin目录；新建项目立即go mod init example.com/myapp生成go.mod；go.sum必须提交以保障依赖一致性；gopls需在module根目录下运行。
Go 环境搭得对不对，直接决定你写代码时是不是总在 go: command not found、cannot find package 或 undefined: fmt 里打转。核心就一条：别碰 GOPATH 模式，从第一天起就用 go mod + 正确的 PATH。
确认 go 命令可用且版本 ≥ 1.16
这是所有后续操作的前提。很多问题其实卡在这一步，但错误提示不明显。
- 运行
go version，输出必须是类似go version go1.21.0 darwin/arm64的格式；低于 1.16 的版本默认关闭模块支持，会 silently 回退到旧式GOPATH行为 - 如果报
command not found，不是没装 Go，而是PATH没包含 Go 的 bin 目录（通常是/usr/local/go/bin或$HOME/sdk/go/bin） - macOS 用户注意：Apple Silicon 机器上，若安装的是 arm64 版本 Go，但终端跑在 Rosetta 下（x86_64），
go命令可能启动失败，此时需统一架构
初始化项目必须用 go mod init
不要手动建 src/ 目录，不要设 GOPATH，更不要把项目放在 $GOPATH/src 里 —— 这些都是 Go 1.11 以前的老习惯，现在只会引发依赖冲突和 replace 失效。
- 新建项目目录后，立即执行
go mod init example.com/myapp（模块名建议用域名+路径，不用本地路径如./myapp） - 执行后生成
go.mod文件，里面第一行就是module example.com/myapp，这是整个模块的根标识，后续所有import都基于它解析 - 如果已有旧项目没
go.mod，直接在根目录下运行go mod init即可迁移，Go 会自动扫描import并写入依赖 - 注意：
go mod init不会自动下载依赖，要拉取第三方包才需go get或首次go run触发
go get 之后记得检查 go.sum 和 vendor（如启用）
go get 看似简单，但它背后控制着依赖锁定、校验和可重现构建，跳过验证步骤容易导致“在我机器上能跑”的线上事故。
-
go get会更新go.mod和go.sum；go.sum是每个依赖包的 checksum 记录，删掉它会导致下次go build重新校验并可能失败 - 团队协作中，务必提交
go.sum，否则不同人go mod download可能拿到被篡改或不同版本的包 - 若项目启用
vendor（通过go mod vendor生成），则构建时默认只读vendor/目录，此时go.sum仍需保留 —— 它用于验证vendor/内容是否与原始 checksum 一致 - 慎用
go get -u：它会升级间接依赖，可能引入不兼容变更；生产环境推荐用go get pkg@v1.2.3显式指定版本
编辑器里 gopls 报错常见原因
VS Code 的 Go 插件或 GoLand 底层都依赖 gopls（Go Language Server），它挂了，智能提示、跳转、重命名就全废，但错误常被误认为是代码问题。
- 典型现象：
no packages found、failed to load workspace、光标悬停无提示 —— 先检查当前目录是否在 module 根下（即有go.mod） -
gopls默认只处理 module-aware 模式；如果打开的是单个.go文件而非整个 module 目录，它会降级为“文件模式”，功能大幅缩水 - 重启
gopls：VS Code 中按Cmd+Shift+P→ 输入 “Go: Restart Language Server”；GoLand 在Help → Diagnostic Tools → Restart Backend Language Server - 偶尔
gopls缓存损坏，可删$HOME/Library/Caches/gopls（macOS）或对应平台缓存目录后重启
真正卡住人的，往往不是“怎么装”，而是“装完以为好了，结果某个隐式依赖或路径偏差让工具链悄悄降级”。盯住 go.mod 是否存在、go version 是否够新、gopls 是否在 module 模式下运行 —— 这三处出问题，90% 的“环境配置失败”都能快速定位。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
