先确认path是否包含go的bin目录：macos/linux运行which go验证，若无输出则需将/usr/local/go/bin等路径写入~/.zshrc并source；windows需在系统环境变量中添加c:\go\bin并重启终端。
go version 报 command not found 怎么办
这不是没装 Go，是 shell 找不到 go 二进制文件。关键看 PATH 是否包含 Go 的 bin 目录。
- macOS/Linux：运行
which go，没输出就说明路径没加对；确认/usr/local/go/bin（或你解压的实际路径）已写入~/.zshrc或~/.bash_profile，然后执行source ~/.zshrc - Windows：PowerShell 中运行
Get-Command go，失败就去「系统属性 → 高级 → 环境变量」，把C:\Go\bin加进「系统变量」里的Path - 别信安装器勾选的“添加到 PATH”——它常不生效；改完必须重启终端或手动
source，否则go version依然报错
go mod init 失败或生成空/错乱的 go.mod
go mod init 很挑上下文，不是在任意目录敲了就能用。
- 先删掉项目根目录下的
vendor/（除非你明确要用 vendor） - 运行
go env -w GO111MODULE=on强制启用模块模式（Go 1.16+ 默认开启，但 CI 或老脚本可能关着） - 确认当前目录不在
$GOPATH/src下——如果在，go mod init会按旧路径推导 module 名，大概率出错；建议切到任意非$GOPATH路径新建项目 -
go mod init前，目录下至少得有一个.go文件，否则可能静默失败
VS Code 里 gopls 启动失败或跳转失效
gopls 不是装上插件就自动好使的，它严格依赖三件事：go 命令可用、go.mod 存在、文件后缀合规。
-
gopls报 “command not found”：说明 VS Code 没读到你的 shellPATH，去设置里填"go.goroot": "/usr/local/go"（路径按实际改） - 打开文件夹后一直转圈：检查根目录有没有
go.mod；没有就先跑go mod init example.com/foo - 跳转定义失效：确认文件是
.go后缀，且没被//go:build ignore屏蔽，也没写空的package main卡住解析
go install xxx@latest 提示 cannot find module providing package
这不是环境坏了，是你在某个模块目录里直接敲了 go install，Go 1.16+ 默认只认模块上下文。
- 退出当前项目目录，回到任意空目录再执行
go install golang.org/x/tools/gopls@latest - 确保
$GOPATH/bin已加入PATH，否则装完也找不到命令 - 检查
go env GOPROXY是否设为https://goproxy.cn,direct；国内不配代理基本拉不到包 - 最常被忽略的是
GOROOT和系统自带 Go 冲突——比如 macOS 用 Homebrew 装过旧版，又手动解压新版，go version显示的可能是旧版本
真正卡住人的从来不是“怎么装”，而是 PATH、GOROOT、GO111MODULE、GOPROXY 这四者之间的隐式依赖关系。任何一个环节没对齐，错误表现都可能完全不相关——比如 gopls 启动失败，根源可能是 go.mod 缺失，也可能是 GO_PROXY 设错导致模块下载超时卡死，最后反馈成 IDE 无响应。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
