根本原因是PATH未正确配置；Windows需检查系统环境变量中是否含Go的bin路径并重启终端，macOS/Linux需确认shell配置文件（如~/.zshrc）已添加/usr/local/go/bin并执行source生效。
go version 报 command not found 怎么办
根本不是 Go 没装好，而是 go 命令没进 PATH。Windows 上常见于安装器勾选了“添加到 PATH”但没重启终端；macOS/Linux 更常因 shell 配置文件（~/.zshrc 或 ~/.bash_profile）没写对路径或没执行 source。
- Windows：用 PowerShell 运行
Get-Command go，失败就去「系统属性 → 高级 → 环境变量」检查%GOROOT%\bin是否在用户或系统 PATH 里 - macOS/Linux：运行
which go，无输出就确认/usr/local/go/bin（pkg 安装）或$HOME/sdk/go/bin（手动解压）是否已加进 shell 配置，并执行source ~/.zshrc - 别信安装器自动配置——它可能只改了当前会话的 PATH，重启终端或手动重载才生效
go mod init 失败或生成错误 module 名
旧项目残留的 vendor/ 目录、关闭模块模式的环境变量、或项目路径落在 $GOPATH/src 下，都会让 go mod init 静默出错或推导出奇怪的 module 名（比如 src/github.com/xxx）。
- 先运行
go env -w GO111MODULE=on强制启用模块模式（Go 1.16+ 默认开启，但 CI 或老脚本可能关着） - 删掉项目根目录下的
vendor/（除非你明确要 vendor 依赖） - 检查当前目录是否在
$GOPATH/src下——如果是，go mod init会按 GOPATH 规则猜 module 名，直接切到任意非$GOPATH/src路径再试 - 初始化时显式指定 module 名：
go mod init github.com/yourname/project，避免依赖路径推导
用官方 elasticsearch-go v8 驱动连不上集群
v8 驱动默认要求 HTTPS + Basic Auth，且不兼容 Elasticsearch 7.x 及更早版本。本地单节点开发时，若 ES 启用了安全功能（xpack.security.enabled: true），又没配证书或用户，http://localhost:9200 会直接被拒绝。
- ES 侧临时关闭安全（仅开发）：编辑
config/elasticsearch.yml，加一行xpack.security.enabled: false，重启 ES - Go 侧禁用 TLS 验证（仅开发）：创建 client 时传入
elasticsearch.Config{Transport: &http.Transport{TLSClientConfig: &tls.Config{InsecureSkipVerify: true}}} - 如果 ES 开了 Basic Auth，必须在地址里带凭证：
http://user:pass@localhost:9200，或用elasticsearch.Username/elasticsearch.Password字段显式配置 - v8 驱动不支持 ES 7.x 的 REST API 版本，硬连会报
406 Not Acceptable；确认 ES 版本 ≥ 8.0，或降级用olivere/elastic（v7）
VS Code 里 gopls 启动失败或没提示
gopls 不是插件装上就跑，它依赖三件事：go 命令可用、项目有合法 go.mod、文件后缀是 .go。缺一不可。
立即学习“go语言免费学习笔记（深入）”；
- 终端里能跑
go version和go list，但 VS Code 里不行？检查 VS Code 终端的 shell 是否和你的登录 shell 一致（比如 zsh 用户开了 bash 终端） - 项目根目录下没有
go.mod？运行go mod init example.com/project生成 - 文件名不是
.go后缀（比如main）？VS Code 不识别为 Go 文件，gopls不加载 - 国内用户常卡在
gopls自动下载失败：设置代理go env -w GOPROXY=https://goproxy.cn,direct，再重启 VS Code
IndexRequest 字段缺失或 SearchResponse 结构不匹配。别急着查文档，先 go list -m all | grep elasticsearch 和 curl http://localhost:9200 看 ES 的 version.number，对齐再说。 
