Go环境配置常见问题包括：PATH未正确添加$GOROOT/bin导致go version报错；go mod init失败多因目录已有go.mod或项目名含非法字符；go get报错常由GOPROXY不可达或校验失败引起；本地包导入错误源于包声明与目录结构不匹配或import路径不规范。
go version 报错或找不到命令，说明 PATH 没配对
最常见的情况是解压了 go 二进制包但没把 /usr/local/go/bin（或你自定义的 $GOROOT/bin）加进 PATH。终端重启后变量不生效，source ~/.bashrc 必须执行，且确认文件里写的是 export PATH=$PATH:$GOROOT/bin，不是 $GOROOT 少了 /bin。
容易踩的坑：
-
GOROOT和解压路径不一致（比如解压到/home/user/go却设GOROOT=/usr/local/go） - 用了
sudo tar解压到/usr/local，但普通用户 shell 配置里没加该路径 - 在 zsh 环境下改了
~/.bashrc却没同步到~/.zshrc
go mod init 失败：当前目录不在 GOPATH/src 下怎么办
Go 1.11+ 默认启用模块模式，go mod init 不依赖 GOPATH，只要在空目录下执行即可。报错 cannot find module root 通常是因为：
- 当前目录已有
go.mod文件（删掉重试） - 父目录存在
go.mod，Go 会向上查找，导致初始化位置错误 - 项目名含非法字符（如大写字母开头的本地路径名
MyProject应改为myproject或带域名前缀example.com/myproject）
示例：mkdir myapp && cd myapp && go mod init example.com/myapp
立即学习“go语言免费学习笔记（深入）”；
go get 报错：module lookup failed 或 checksum mismatch
本质是代理或校验问题，不是网络连不上。默认 GOPROXY 是 https://proxy.golang.org，国内访问常超时或被拦截。
解决方式（任选其一）：
- 临时设置：
go env -w GOPROXY=https://goproxy.cn,direct - 永久生效（推荐）：
echo 'export GOPROXY=https://goproxy.cn' >> ~/.bashrc && source ~/.bashrc - 禁用校验（仅调试用）：
go env -w GOSUMDB=off，但上线前务必关掉
注意：go get 在模块模式下会自动写入 go.mod 和 go.sum，别手动编辑这两文件。
本地包 import 不起：main 包和非 main 包混放
Go 要求同一目录下所有 .go 文件必须属于同一个包，且 main 包只能有一个入口函数 func main()。常见错误：
- 把
api.go和main.go放同一目录却分别声明package api和package main→ 编译报错 - 想复用代码，但没建子目录，直接在
main目录里写package utils→ Go 拒绝编译 - 导入本地包时路径写错，比如
import "myproject/utils"，实际目录结构是myproject/utils/utils.go，但没在项目根运行go mod init myproject
正确做法：每个逻辑单元单独建目录，import 路径对应文件系统相对路径（从模块根开始），例如 import "./utils" 仅限同级，生产环境应避免。
GOPROXY、go.mod 位置、以及包路径和文件系统路径的映射关系——这三处出错，编译器报的错往往不直接说“你路径错了”，而是抛一堆 module 或 import 相关的模糊提示。 
