go version报“command not found”说明go二进制未加入path；linux/macos需在~/.zshrc或~/.bash_profile中添加export path=$path:/usr/local/go/bin并source，windows需将%goroot%\bin加入系统path环境变量。
go version 命令没反应或报“command not found”
说明 go 二进制文件不在系统 PATH 中，这是安装后最常遇到的问题。
- Linux/macOS：检查是否在
~/.bashrc、~/.zshrc或/etc/profile中添加了export PATH=$PATH:/usr/local/go/bin（Linux/macOS pkg 默认路径）或export PATH=$PATH:$HOME/go/bin（自定义解压安装） - Windows：确认系统环境变量
Path中包含%GOROOT%\bin，且GOROOT指向正确目录（如C:\Go） - 终端重启后仍无效？执行
source ~/.zshrc（macOS/Linux）或新开命令提示符（Windows），避免仅修改未生效 - 验证路径是否存在：
ls /usr/local/go/bin/go或dir C:\Go\bin\go.exe
GO111MODULE=on 但 go mod init 失败或提示 “not in a module”
模块模式启用后，go 命令默认要求项目位于模块根目录下，否则拒绝初始化或依赖操作。
- 必须在空目录中执行
go mod init example.com/myapp，不能在$GOPATH/src下直接运行（旧式 GOPATH 工作区与模块冲突） - 如果当前目录已有
go.mod但内容损坏，先删掉再重试；若存在vendor/目录，也建议临时移除 - 注意：模块名不强制对应远程仓库地址，但建议用有意义的域名前缀（如
github.com/yourname/project），避免后续go get解析失败 - Windows 用户特别留意路径分隔符：模块名中不要出现反斜杠
\，否则go mod会解析异常
GOPROXY 设置后仍卡在 “Fetching …” 或报 “403 Forbidden”
代理配置看似正确，但实际请求被拦截或跳转失败，常见于国内镜像策略变更或网络中间件干扰。
- 优先使用已验证稳定的国内代理：
https://goproxy.cn或https://proxy.golang.org（需科学上网） - 多个代理用英文逗号分隔，末尾加
,direct作为兜底：go env -w GOPROXY=https://goproxy.cn,https://proxy.golang.org,direct - 某些企业网络会拦截
proxy.golang.org的 TLS SNI，可尝试改用https://goproxy.io（已停服）或切换为https://mirrors.aliyun.com/goproxy/ - 临时关闭代理调试：
go env -w GOPROXY=off，再go mod download看是否纯网络问题
go install gopls@latest 报错 “no required module provides package”
这是 Go 1.16+ 后模块感知工具链的典型报错，本质是 go install 不再隐式创建 go.mod，而要求明确上下文。
- 解决方案：**不要在任意目录下直接运行该命令**，而是切换到一个空目录或模块根目录后再执行
- 更稳妥的做法是全局安装（不依赖当前模块）：
go install golang.org/x/tools/gopls@latest—— 注意这里用的是完整导入路径，不是相对路径 - 如果提示
gopls已存在但版本旧，先删掉旧二进制：rm $(go env GOPATH)/bin/gopls（Linux/macOS）或del %GOPATH%\bin\gopls.exe（Windows） - VS Code 中若提示 “gopls not found”，检查设置里
go.goplsPath是否指向正确位置，或重启编辑器使新安装生效
GOPATH 仅影响 go install 输出的二进制存放位置，和代码组织完全无关。很多人还在纠结 GOPATH/src 目录结构，其实只要 go mod init 成功，项目就可以放在任何路径下。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
