Go命令能运行仅说明PATH正确，但go mod init失败常因GO111MODULE=off未启用；GOROOT必须与which go路径严格一致，GOPATH在模块化项目中可不设，gopls依赖PATH、go.mod存在及.go文件合规。
Go 命令能跑起来，环境变量就基本够用了；但 GOROOT、GOPATH、PATH 这三个值填错或漏掉任意一个，go run 或 gopls 就会静默失败或报“command not found”。
为什么 go version 成功但 go mod init 报错？
常见现象是终端里能执行 go version，但进项目目录运行 go mod init example.com/foo 却提示 go: unknown subcommand "mod" 或直接卡住——本质是模块模式没启用，或当前 shell 读到了旧的 GO111MODULE=off 环境变量。
- 用
go env GO111MODULE查当前值，输出必须是on（Go 1.16+ 默认开启，但老系统或 Docker 镜像可能仍关着） - 强制开启：运行
go env -w GO111MODULE=on（注意不是export） - 如果之前手动设过
export GO111MODULE=off在~/.zshrc里，删掉那行再source ~/.zshrc - Windows PowerShell 用户别用
$env:GO111MODULE="on"临时设置——go env -w才写入持久配置
GOROOT 和 GOPATH 到底还要不要配？
Go 1.21+ 已默认关闭 GOPATH 模式，GOROOT 大多也不用手动设——但前提是 go 命令本身路径正确。装完后第一件事不是急着配 GOPATH，而是确认 go 落在哪：
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
- macOS/Linux：运行
which go，输出类似/usr/local/go/bin/go，说明它在/usr/local/go；这时GOROOT就该设为/usr/local/go - Windows：PowerShell 里运行
Get-Command go，看Path字段，取到\bin\go.exe上一级目录作为GOROOT -
GOPATH只在你需要go install第三方命令（比如dlv、staticcheck）时才需要；若只写代码、依赖管理全靠go.mod，可完全不设GOPATH - 设了
GOPATH就别让它和项目目录重叠，否则go mod vendor可能误把本地包当外部依赖处理
VS Code 里 gopls 启动失败，90% 是这三个地方错了
gopls 不是独立进程，它依赖当前 shell 的 PATH、项目根目录结构、以及文件后缀三者同时合规。报错 “cannot find package” 或一直转圈，先查这三项：
立即学习“go语言免费学习笔记（深入）”；
- 打开 VS Code 的
Developer: Toggle Developer Tools→ Console 标签页，看第一行错误是不是gopls: command not found？如果是，说明 VS Code 没读到你的 shell PATH —— 在 VS Code 设置里加"go.goroot": "/usr/local/go"（路径按which go输出填） - 确保你用
File → Open Folder打开的是含go.mod的目录；如果只是File → Open File打开单个.go文件，gopls无法推导模块上下文 - 检查文件名是否为
main.go且包声明是package main；若写成package foo又没go.mod，gopls会跳过解析
最容易被忽略的一点：Go 安装包自带的 go 命令路径，和你在编辑器里配的 go.goroot 必须严格一致；哪怕只差一个字符（比如 /usr/local/Go 写成 /usr/local/go），gopls 就会找不到标准库路径，所有跳转、补全全部失效。
