根本原因是path未生效或go安装路径未加入环境变量，需根据系统检查并配置path；go mod init失败多因路径误用或模块模式未启用；交叉编译须设cgo_enabled=0确保静态链接；gopls依赖正确项目结构、go命令可用及goproxy代理。
go version 报 command not found 怎么办
根本原因不是没装 Go，而是终端压根找不到 go 命令——PATH 没生效，或安装路径没加进去。
- Windows：用 PowerShell 运行
Get-Command go，失败就去「系统属性 → 高级 → 环境变量」里确认C:\Program Files\Go\bin（或你实际的安装路径）是否在用户或系统 PATH 中；别信安装器勾选的“添加到 PATH”，必须重启终端或手动刷新 - macOS/Linux：运行
which go，没输出就检查~/.zshrc或~/.bash_profile里有没有这行：export PATH=$PATH:/usr/local/go/bin（Linux 手动解压安装时路径可能是/usr/local/go/bin，macOS pkg 安装默认也是这个）；改完记得source ~/.zshrc - 统信 UOS 等国产系统：APT 安装后可能只配了 root 的 PATH，普通用户仍需手动把
/usr/lib/go-1.22/bin（路径以apt show golang输出为准）加进自己 shell 配置
go mod init 失败或生成错误 module 名
常见于旧项目迁移或误操作，go mod init 不是“点一下就完事”的命令，它会根据当前路径推导 module 名，而 GOPATH/src 下的路径会被强行转成类似 github.com/xxx/yyy 的形式，极易出错。
- 先清理干扰项：删掉项目根目录下的
vendor/目录（除非你明确要 vendor） - 确认模块模式已启用：
go env -w GO111MODULE=on（Go 1.16+ 默认开启，但 CI 脚本或老环境可能关着） - 别在
$GOPATH/src里初始化——切到任意其他目录，比如~/projects/myapp，再运行go mod init myapp - 如果已有
go.mod但内容异常，直接删掉重来；module 名建议用小写字母、数字、短横线，避免下划线和大写
交叉编译 Linux 二进制文件却无法运行
本地 Windows/macOS 编译出的文件，在 Linux 上报 no such file or directory 或直接闪退，通常不是架构问题，而是动态链接器不兼容或缺少 libc。
- 优先使用静态链接：编译前加环境变量
CGO_ENABLED=0，例如CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o myapp . - 不要依赖
go run那套开发流程——生产部署只认go build出来的二进制，且必须指定GOOS和GOARCH - Linux ARM64 服务器（如树莓派、鲲鹏）要配
GOARCH=arm64，别用默认的amd64；M1/M2 Mac 编译给 Intel Linux 用，得设GOARCH=amd64 - 上传后记得
chmod +x myapp，否则./myapp会提示 permission denied
VS Code 里 gopls 启动失败或无代码提示
gopls 是语言服务器，不是插件装上就自动好使的，它严格依赖项目结构和 go 命令可用性。
- 先确保终端里能跑通
go version和go list -m（项目有go.mod时） - VS Code 必须打开的是**整个项目根目录**（含
go.mod），不能只打开单个.go文件 - 检查文件后缀是不是
.go，且包声明是package main（非main包不会触发完整分析） - 国内用户务必配代理：
go env -w GOPROXY=https://goproxy.cn,direct，否则gopls初始化时会卡在下载工具链
最常被忽略的一点：交叉编译生成的二进制文件，即使 file myapp 显示 “ELF 64-bit LSB executable”，也不代表一定能跑——CGO_ENABLED=0 是多数服务端部署的底线要求，否则 libc 版本差异会让程序在目标机器上直接崩溃。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
