go环境搭建卡点在于go命令全局可用、模块模式启用及避开gopath/src路径陷阱；需验证which go有输出、go env -w go111module=on，并确保go mod init在非gopath路径执行且目录含.go文件。
Go 环境搭建本身不难，真正卡住人的从来不是“怎么装”，而是“装完命令找不到”或“go mod init 生成错乱 module 名”。核心就三件事：确保 go 命令全局可用、明确当前是否启用模块模式、避开 GOPATH/src 路径陷阱。
验证 go 命令是否真能用
很多人点开终端就输 go version，看到 command not found 就懵了——不是没装好，是 shell 没加载新 PATH。
- Windows：在 PowerShell 中运行
Get-Command go，若无输出，去「系统属性 → 高级 → 环境变量」检查%GOROOT%\bin是否已加入 Path（用户变量或系统变量均可）；改完必须重启终端，source不生效 - macOS/Linux：运行
which go，若为空，检查/usr/local/go/bin（官方 pkg）或$HOME/go/bin（源码编译）是否写进了~/.zshrc或~/.bash_profile；改完执行source ~/.zshrc - 别信安装器勾选的“添加到 PATH”——它可能只写进某个用户的配置，或根本没写；手动确认最稳
go mod init 失败的三个常见诱因
新建目录后直接 go mod init myproj 却生成 module github.com/xxx/yyy 或报错？大概率掉进了路径推导陷阱。
- 当前目录在
$GOPATH/src下：go mod init会尝试从路径反推 module 名，比如$GOPATH/src/github.com/user/app→module github.com/user/app；切到任意非GOPATH路径再试 -
GO111MODULE被设为off：运行go env -w GO111MODULE=on强制开启（Go 1.16+ 默认 on，但某些旧脚本或 CI 环境仍关着） - 目录下存在
vendor/或残留的go.mod：go mod init会静默失败或覆盖错误；先rm -rf vendor go.mod go.sum
VS Code 中 gopls 启动失败的硬性前提
gopls 不是装上插件就自动跑起来的，它依赖三个确定状态：
-
go命令必须在终端里能调用（即上文验证过的which go有输出） - 项目根目录下必须有
go.mod文件（go mod init后生成），且文件不能为空 - 打开的文件后缀必须是
.go，且不能在vendor/或GOPATH/src内部打开
最易被忽略的是：即使 go version 成功，gopls 也可能因 shell 配置未加载而找不到 go。VS Code 的集成终端默认加载 ~/.zshrc，但 GUI 启动的 VS Code 可能只读 ~/.zprofile —— 把 PATH 相关 export 放到后者里更保险。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
