Go环境能跑起来的关键是go命令全局可用、go run可执行、go mod能拉依赖；需检查PATH和GOROOT是否生效，初始化go.mod，配置GOBIN并加入PATH，VS Code需手动安装gopls并设goplsPath。
Go 环境能跑起来，关键不是装了没，而是 go 命令能在任意目录执行、go run 能编译运行、go mod 能正常拉依赖——三者缺一不可。其他配置都是锦上添花。
go version 不识别？检查 PATH 和 GOROOT 是否生效
这是最常卡住的第一步。安装完 .msi/.pkg/.tar.gz 后，go version 报 command not found 或 'go' is not recognized，说明 shell 没找到 go 二进制文件。
- 先确认 Go 安装路径：Windows 默认是
C:\Go\bin，macOS/Linux 默认是/usr/local/go/bin - 检查
PATH是否包含该路径：在终端运行echo $PATH（macOS/Linux）或echo %PATH%（Windows CMD），看输出里有没有对应目录 -
GOROOT一般不用手动设——官方安装包会自动写入；但如果你手动解压到非默认路径（比如/opt/go），就必须显式设置：export GOROOT=/opt/go，且确保$GOROOT/bin在PATH前面 - 修改完配置文件（如
~/.zshrc或~/.bash_profile）后，必须执行source ~/.zshrc生效，重启终端不等于重载配置
go run main.go 报错“no required module”？立刻初始化模块
Go 1.16+ 默认启用模块模式（module mode），但新目录下没有 go.mod 文件时，go run 会拒绝执行，报错类似：go: no required module provides package command-line-arguments。
- 进入项目根目录（比如
~/myapp），运行go mod init example.com/myapp——模块名不必真实存在，只是逻辑标识 - 模块名建议用域名反写（如
github.com/yourname/project），避免和标准库冲突；不要用main或go这类保留字 - 初始化后会生成
go.mod文件，内容至少包含module和go版本行；此时再go run main.go就能成功 - 如果项目已有
go.mod但报依赖问题，优先试go mod tidy，而不是删掉重来
VS Code 提示 “Go command not found” 或 gopls 启动失败？别急着重装插件
VS Code 的 Go 插件（Go Team 官方版）依赖系统 PATH 中的 go 命令，也依赖 gopls 语言服务器。常见现象是右下角弹窗卡在 “Installing tools…” 或直接报错。
立即学习“go语言免费学习笔记（深入）”；
- 先在终端里确认
go version和which go正常，再打开 VS Code ——很多情况下 VS Code 启动时没读取到 shell 的 PATH，尤其是 macOS 上用 GUI 启动的 VS Code - 不要点插件提示的 “Install All”，改用终端手动装：
go install golang.org/x/tools/gopls@latest，装完会输出二进制路径（如$HOME/go/bin/gopls），把这个路径加进 VS Code 的"go.goplsPath"设置里 - 国内用户遇到超时，务必提前设代理：
go env -w GOPROXY=https://goproxy.cn,direct，否则gopls和dlv都可能拉不到 - 插件配置里关掉 “Auto-generate go.mod” 选项，避免它在不该初始化的地方强行创建空模块
go install 生成的可执行文件找不到？GOBIN 必须加入 PATH
go install 默认把编译好的二进制放到 $GOBIN（若未设则 fallback 到 $GOPATH/bin），但它不会自动加到 PATH。所以你 go install ./cmd/mytool 成功后，直接敲 mytool 会报 command not found。
- 显式设置
GOBIN：比如export GOBIN=$HOME/go/bin，然后确保$GOBIN在PATH里（顺序无所谓，但必须存在） - 验证方式：运行
go install fmt（会失败但没关系），然后看ls $GOBIN是否有文件；再试which mytool - 注意：
GOBIN和GOPATH是两回事——GOPATH在模块时代已弱化，但GOBIN仍控制go install输出位置，必须显式管理 - Windows 用户容易漏掉：PowerShell 和 CMD 的环境变量隔离，改完系统变量后，要关掉所有终端窗口重开
真正麻烦的从来不是“装不上”，而是 PATH 没生效、模块没初始化、GOBIN 没纳管——这三个点串起来，90% 的环境问题就解决了。剩下的是网络、权限、IDE 缓存这些具体场景里的小摩擦，盯住日志里第一个报错，别跳着修。
