Go 1.11后环境搭建核心是go mod能否正常工作；需确保GO111MODULE=on、项目不在$GOPATH/src下、用go mod init初始化模块、配置GOPROXY=https://goproxy.cn,direct，并通过go mod tidy同步依赖。
Go 1.11 之后的环境搭建，核心就是模块（module）可用不可用——不是装了 Go 就能直接开干，go mod 能否正常工作，才是现代 Go 项目启动的第一道门槛。
go mod init 执行失败：找不到 go.mod 或提示“not in a module”
这是最常遇到的“环境看似正常、项目却跑不起来”的典型现象。根本原因不是 Go 没装好，而是当前目录未被识别为模块根目录，或 GO111MODULE 环境变量被意外关闭。
-
GO111MODULE必须为on（Go 1.16+ 默认开启，但某些旧 shell 配置或 CI 环境仍可能设为auto或off），检查方式：go env GO111MODULE - 执行
go mod init example.com/myapp前，确保当前路径是空目录或只含源码文件（不能在$GOPATH/src下机械套用旧习惯） - 若提示
cannot determine module path，说明目录名不含合法域名格式；可显式指定路径，比如go mod init myapp（不推荐用于生产，但调试时有效） - Windows 用户注意路径分隔符：不要用反斜杠
\写模块路径，go mod init github.com/user/project才是标准写法
依赖下载超时或 403：go get 失败、proxy 不生效
国内开发者常卡在这一步——go get 直连 goproxy.io 或 proxy.golang.org 失败，并非网络问题，而是 GOPROXY 配置未覆盖所有协议或被本地 git 配置干扰。
- 设置代理必须包含
https://goproxy.cn,direct或https://proxy.golang.org,direct（direct是 fallback，不能省略） - 验证是否生效：
go env GOPROXY应输出完整字符串，而非空或off - 某些企业内网会拦截 HTTPS CONNECT 请求，此时需额外配置 git 的 http.sslVerify=false（仅限可信内网，不建议全局启用）
- 若用
go install安装命令行工具（如gofumpt），要加@latest后缀：go install mvdan.cc/gofumpt@latest，否则可能报 “no matching versions”
go build 生成二进制后无法运行：missing dynamic link or permission denied
Go 编译出的是静态链接二进制，但仍有两类常见运行失败场景：一是目标系统缺失 libc 兼容层（尤其 Alpine），二是文件权限或 SELinux 限制。
立即学习“go语言免费学习笔记（深入）”；
- Linux 上用
go build -ldflags="-s -w"可减小体积并剥离调试信息，但不会影响运行；真正要注意的是 CGO_ENABLED —— 若设为0，则完全禁用 C 链接，适合 Alpine 镜像，但部分依赖（如 SQLite、某些 DNS 解析）会失效 - 交叉编译到不同 OS/ARCH 后，别忘了用
file命令确认目标平台：file myapp输出应含ELF 64-bit LSB executable, x86-64等字样 - macOS 上若提示 “damaged and can’t be opened”，需手动右键“打开”一次解除 Gatekeeper 限制；Linux 上若报
Permission denied，先chmod +x myapp
go run 与 go build 行为不一致：为什么本地能跑、部署就 panic？
这不是 bug，而是模块加载路径和工作目录的隐式差异导致的——go run 在当前目录找 go.mod，而 go build 后执行二进制时，os.Executable() 返回路径和 os.Getwd() 可能完全不同。
- 读取配置文件、模板、嵌入资源时，绝对路径要用
runtime.GOROOT()或os.Executable()推导，别依赖./config.yaml - 使用
embed包时，//go:embed路径是相对于源文件所在目录，不是执行目录；打包进二进制后，路径语义已固化 - CI/CD 中若用
go build生成二进制再 scp 到远程，记得同步整个资源目录（除非全用embed），否则go run成功只是因为开发机上恰好有那些文件
模块化不是开关，是约束——它强制你声明依赖、锁定版本、明确路径。最容易被忽略的，是把 go.mod 当成“配置文件”而不是“契约文件”：一旦提交，所有协作者和构建环境都必须遵守其中的 go 版本和依赖树，任何绕过它的临时修复，都会在下次 go mod tidy 时暴露出来。
