Go环境问题90%是环境链路断点：先验证which go和go version是否成功，再确保VS Code从终端启动、gopls安装正确、项目含go.mod且文件以.go结尾，三者缺一不可。
Go 环境根本不用“装 IDE”，真正卡住人的从来不是语法，而是 go 命令压根找不到、gopls 启动失败、go run 报错却没提示到底哪错了——这些全是环境链路断点，不是代码问题。
go command not found？先别重装，查 PATH 是否真生效
安装包点完「Install」不等于终端能认出 go。Windows 上 PowerShell 运行 Get-Command go 没输出，macOS/Linux 执行 which go 返回空，说明 PATH 没生效，不是没装好。
- Windows：去「系统属性 → 高级 → 环境变量」确认
C:\Program Files\Go\bin（或你自定义的GOROOT/bin）进了用户或系统 PATH；改完必须重启终端，source不起作用 - macOS/Linux：检查
~/.zshrc或~/.bash_profile里是否加了export PATH=$PATH:/usr/local/go/bin（路径要和实际GOROOT一致）；改完执行source ~/.zshrc，再测which go - 统信 UOS 等国产系统：APT 安装后可能只配了
GOROOT，漏了$GOROOT/bin到 PATH，得手动补上
go mod init 失败？八成是旧项目残留干扰
go mod init 在有 vendor/ 目录、GO111MODULE=off 或当前路径落在 GOPATH/src 下时，会静默失败或生成错误 module 名，而不是报错。
- 运行
go env -w GO111MODULE=on强制启用模块模式（Go 1.16+ 默认开启，但 CI 脚本或老终端可能关着） - 删掉项目根目录下的
vendor/（除非你明确需要 vendor） - 用
pwd看当前路径是否在$GOPATH/src下——如果是，go mod init会按旧 GOPATH 规则推导 module 名，大概率错；切到任意非GOPATH路径新建项目更干净
VS Code 里 gopls 启动失败？三个硬性前提缺一不可
gopls 不是插件装上就跑，它依赖底层 go 可用、项目有 go.mod、文件后缀是 .go，三者缺一，状态栏就一直显示 “Loading…”。
立即学习“go语言免费学习笔记（深入）”；
- 终端里能跑
go version，VS Code 内置终端也得能——否则插件找不到go二进制 - 项目根目录必须有
go.mod（哪怕只是空文件，go mod init example.com/foo生成的），否则gopls不认为这是 Go 项目 - 打开的文件名必须以
.go结尾，且内容是合法 Go 语法（比如package main开头），否则语言服务器拒绝加载
go run 和 go build 怎么选？开发阶段别编译，但上线前必须 build
go run 是开发调试的快捷键，go build 是交付前的必经步骤，两者行为差异直接影响可执行文件行为。
-
go run main.go：编译临时二进制 → 执行 → 自动清理；适合快速验证逻辑，但无法调试生成的二进制，也不能设参数如-ldflags -
go build -o app main.go：生成持久可执行文件app（Windows 为app.exe），可分发、可调试、可加构建参数（比如-ldflags="-s -w"减小体积） - 模块项目中直接
go build（不带文件名）：默认输出文件名取自go.mod的 module 名，不是当前目录名；想控制输出名，必须显式用-o
真正容易被忽略的是：go run 不会触发 go mod tidy，依赖缺失时只报错不自动拉取；而 go build 会尝试解析全部 import 并校验模块完整性——所以编译失败时，先看是不是 go mod tidy 没跑全。
