必须在写代码前初始化go mod，否则相对路径import会失败；模块名需与import路径一致，且必须在项目根目录执行go mod init；GOPATH仅影响go install输出和旧脚本兼容，不应再用于存放源码。
go mod 初始化时机直接影响后期依赖管理是否可控
环境变量配置错误会直接导致 go build 或 go run 找不到模块、无法解析本地包
为什么 go mod init 不能拖到写完代码再做
很多新手在写完 main.go 后才执行 go mod init myapp，结果发现 import "./handler" 报错：cannot load ./handler: cannot find module providing package。这是因为 Go 模块系统默认只识别 import 路径中以域名或合法模块名开头的路径（如 myapp/handler），不支持相对路径导入。
- 必须在项目根目录执行
go mod init，且模块名要与后续import路径前缀一致（比如设为example.com/myapp，则import "example.com/myapp/handler"才有效） - 如果项目已含子目录，建议先建好结构再初始化：
mkdir -p cmd/api internal/handler，再go mod init example.com/myapp - 一旦
go.mod生成，后续所有go get、go build都基于此文件解析依赖，改名或移动目录会导致go list失败
GOPATH 还要不要配？配错会怎样
Go 1.11+ 默认启用模块模式，GOPATH 不再决定项目位置，但仍有两处关键影响：
-
GOPATH/bin是go install默认输出可执行文件的位置；若未加入$PATH，安装的 CLI 工具（如golangci-lint）将无法全局调用 - 某些旧脚本或 CI 配置仍硬编码
$GOPATH/src，若你把项目放在$HOME/go/src下又没设GOPATH，go build可能静默失败（尤其在 Docker 构建时） - 推荐做法：保留
GOPATH=$HOME/go，但不依赖它放源码；所有新项目都用模块路径管理，go mod自动处理依赖缓存到$GOPATH/pkg/mod
开发工具链缺失导致调试器/格式化器失效
VS Code 的 Go 插件（gopls）启动失败、保存不自动格式化、跳转定义报 “no packages found”，90% 是因为底层工具没装全：
- 必须手动运行一次：
go install golang.org/x/tools/gopls@latest（否则gopls不会自动下载） -
go fmt和go vet是标准命令，但dlv（调试器）、staticcheck等需单独go install - Linux/macOS 上若没装
build-essential或xcode-select --install，遇到含 CGO 的包（如数据库驱动）会卡在#include <sys/socket.h>找不到头文件
go mod 范围、GOPATH 边界、工具链完整性的模糊处理——它们不会当场报错，但会在两周后的某次 go get -u 后集中爆发。 
