go version报错是PATH未配置，需手动添加GOROOT/bin；go mod init报错因项目在GOPATH/src下，应移出；go run报错因缺go.mod或import路径不匹配；go get卡住应设GOPROXY=https://goproxy.cn,direct。
go version 命令报错或不识别？检查 PATH 和安装路径是否生效
装完 Go 后执行 go version 提示 command not found 或 bash: go: command not found，大概率是 PATH 没配对。官方安装包（如 macOS 的 .pkg、Windows 的 .msi）通常会自动把 $GOROOT/bin 加进 PATH，但 Linux 的 .tar.gz 包不会——你得手动加。
验证方法：先确认 go 二进制在哪：
ls -l /usr/local/go/bin/go # macOS/Linux 默认路径 ls -l "C:\Go\bin\go.exe" # Windows 默认路径
如果文件存在，就说明安装成功，只是 shell 找不到它。此时需补 PATH：
- macOS/Linux：在
~/.zshrc（或~/.bash_profile）里加一行：export PATH=$PATH:/usr/local/go/bin - Windows：在「系统属性 → 高级 → 环境变量」里，编辑用户或系统级的
Path，新增C:\Go\bin - 改完别忘了重开终端，或运行
source ~/.zshrc
注意：不要用 brew install go 或 apt install golang 替代官方包，它们版本滞后（比如 Ubuntu 24.04 默认还是 go1.21，而当前稳定版已是 go1.22），且可能把 go 装到 /usr/bin/go，与官方路径冲突。
立即学习“go语言免费学习笔记（深入）”；
go mod init 报错 “cannot determine module path”？项目目录不能在 GOPATH/src 下
执行 go mod init myapp 时出现这个错误，说明你正处在旧式 GOPATH 工作区里（比如 ~/go/src/myapp）。Go 1.11+ 默认启用 Modules，而 Modules 要求项目根目录**不能**是 $GOPATH/src 的子目录——否则 Go 会误判你在用旧包管理方式，拒绝初始化模块。
解决办法很简单：把项目挪出来，比如：
mkdir ~/projects/myapp cd ~/projects/myapp go mod init myapp
这样就能正常生成 go.mod。顺便说一句，现在 GO111MODULE=on 是默认行为，无需手动设置；GOPATH 也不再影响模块查找逻辑，只用于存放下载的依赖（$GOPATH/pkg/mod）和 go install 的二进制（$GOPATH/bin）。
容易踩的坑：
- 用 IDE 新建项目时，选了“GOPATH mode”，结果自动建在
~/go/src/xxx下 —— 改成“Module mode”或手动移出 -
go mod init后没写包名（如go mod init少参数），也会报类似错误
go run main.go 提示 “no required module provides package …”？go.mod 缺失或 import 路径不对
这个错误本质是 Go 找不到你 import 的包，常见于两种情况：
第一种：项目根本没有 go.mod，但代码里用了非标准库的包（比如 import "github.com/gorilla/mux"）。Go 不会自动下载，必须先有模块定义。
第二种：go.mod 存在，但 import 路径和模块名不一致。例如 go mod init example.com/myapp，但代码里写的是 import "myapp/handler" —— Go 会按 example.com/myapp/handler 去找，找不到就报错。
实操建议：
- 新建项目第一步永远是
go mod init <your-module-name>，模块名建议用域名前缀（如github.com/username/project），避免本地路径 - 所有
import必须以模块名为前缀，比如模块是github.com/abc/app，那子包就得写github.com/abc/app/router - 依赖包用
go get github.com/gorilla/mux@latest显式拉取，它会自动写进go.mod并下载到$GOPATH/pkg/mod
代理配置失败导致 go get 卡住？优先用 GOPROXY，别碰 GOSUMDB
国内直接 go get 经常卡在 Fetching https://proxy.golang.org/... 或超时，是因为默认代理不可达。最稳的解法是设 GOPROXY：
go env -w GOPROXY=https://goproxy.cn,direct
这行命令把代理设为国内镜像（goproxy.cn），direct 表示对私有仓库（如公司内网 Git）直连。不用动 GOSUMDB —— 它控制校验和数据库访问，设成 off 有安全风险，而 goproxy.cn 已内置校验，足够可靠。
验证是否生效：
go env GOPROXY
输出应为 https://goproxy.cn,direct。如果仍卡住，检查是否被本地网络策略拦截（比如某些企业防火墙会封 HTTPS 代理域名），此时可临时切回官方代理试错：go env -w GOPROXY=https://proxy.golang.org,direct。
复杂点在于：一旦设了 GOPROXY，所有依赖都走代理，包括私有模块。若你真要混用（比如公司内部模块走内网，开源模块走代理），得用 git config 或 ~/.gitconfig 配置 submodule 的 URL 重写，而不是靠 Go 环境变量兜底。
