Go开发环境卡点集中在PATH配置、模块模式启用和gopls配置三处：PATH未生效导致go命令不可用；GO111MODULE未开启或项目位于GOPATH/src下致go mod init失败；gopls依赖go.mod和正确环境变量，需手动安装并验证GOPROXY等设置。
Go 开发环境根本不需要“无缝衔接”——它本就轻量、无 IDE 依赖，所谓卡点全在 PATH、模块模式和 gopls 三处。装完 go 命令却 go version 报错？gopls 启动失败？go mod init 没反应？不是环境不兼容，是这三步没踩实。
go command 找不到：PATH 没生效，不是没装好
很多人双击安装包点了“完成”，就以为万事大吉。实际 macOS/Linux 下 which go 为空、Windows 下 Get-Command go 找不到，90% 是 PATH 没刷进当前终端会话。
- macOS/Linux：检查
/usr/local/go/bin（pkg 安装默认路径）是否写进了~/.zshrc或~/.bash_profile；改完必须source ~/.zshrc，别只关再开终端 - Windows：进「系统属性 → 高级 → 环境变量」，确认
C:\Program Files\Go\bin（或你自定义路径）已加到「系统变量」或「用户变量」的Path里；PowerShell 里运行$env:Path看输出里有没有它 - 别信安装器勾选的“添加到 PATH”——它可能只改了注册表某处，但没同步到你的 shell 启动配置
go mod init 不生成 go.mod：模块模式被关着或项目在 GOPATH/src 下
go mod init 静默失败，或者生成的 go.mod 里 module 名是 example.com/xxx 而不是你想要的，大概率是模块模式关闭，或当前目录落在旧式 GOPATH/src 路径里。
- 先执行
go env -w GO111MODULE=on强制启用（Go 1.16+ 默认开，但 CI 或某些脚本可能设为off） - 删掉项目根目录下的
vendor/目录（除非你明确要 vendor） - 用
go env GOPATH查出 GOPATH 路径，然后pwd看当前是否在$GOPATH/src下；如果是，cd出去，新建空文件夹再go mod init yourdomain.com/projectname
VS Code 里 gopls 启动失败：“Go language server is not available”
VS Code 的 Go 插件不是装上就灵，gopls 是个独立二进制，它启动失败，编辑器就退化成纯文本编辑器——跳转、补全、诊断全失效。
立即学习“go语言免费学习笔记（深入）”；
- 确保
go命令本身可用（go version成功），且项目根目录有go.mod（gopls依赖模块信息加载依赖图） - 不要靠“首次打开 .go 文件时自动下载”，手动触发：Cmd+Shift+P → 输入
Go: Install/Update Tools→ 全选，尤其勾中gopls和dlv - 检查
$GOBIN/gopls是否存在且可执行（GOBIN默认是$HOME/go/bin）；若手动改过go.goplsPath设置，留空更安全 - 从终端执行
code .打开项目，比双击图标启动 VS Code 更可靠——能继承 shell 的PATH和环境变量
国内依赖拉取慢或超时：GOPROXY 没配或配错
执行 go get 卡住、go mod download 报 timeout、gopls 日志里反复出现 x/net 或 x/tools 失败，基本就是代理没生效。
- 执行
go env -w GOPROXY=https://goproxy.cn,direct（阿里云镜像也行：https://mirrors.aliyun.com/goproxy/） - 顺手配好
GOSUMDB：执行go env -w GOSUMDB=sum.golang.google.cn，否则go mod download可能因 checksum 校验失败退出 - 验证：运行
go env | grep GOPROXY，输出应为GOPROXY="https://goproxy.cn,direct"；注意末尾的,direct不能丢，它表示对私有模块走直连
最常被忽略的是：gopls 必须读到 go.mod 才算真正“活”起来，而 go.mod 又极度依赖当前目录位置和模块模式开关。这两环断一环，整个语言服务器就瘫一半——不是插件问题，是项目上下文缺失。
