GoLand中必须关闭GOPATH模式，否则会与模块模式冲突导致go.sum被忽略、import报错；应取消Settings→Go→GOPATH中“Enable GOPATH mode”勾选，删旧src目录，并执行go env -w GO111MODULE=on验证。
GoLand 中必须关掉 GOPATH 模式
GoLand 默认可能启用 GOPATH 模式，这和微服务项目要求的 module 模式冲突。一旦开启，go mod init 生成的 go.sum 会被忽略，go run 报 no required module provides package 是最常见症状。
检查方式：打开 Settings → Go → GOPATH，确认 Enable GOPATH mode 未勾选。如果已勾选，取消后重启 GoLand；同时删掉项目根目录下残留的 src/ 子目录——它大概率是旧 GOPATH 遗留结构，会干扰模块路径解析。
验证是否生效：go env -w GO111MODULE=on（Windows 用 go env -w GO111MODULE=on），然后在项目根目录运行 go list -m，应输出模块名如 yourcompany.com/gateway，而非报错或空行。
GOROOT 和 Go SDK 必须指向 1.21+ 二进制安装路径
系统包管理器（如 apt、brew）装的 Go 常为 1.18 或更低，会导致泛型语法报错、go.sum 校验失败、net/http 新增方法（如 http.NewServeMux 的 WithPrefix）不可用。
操作步骤：
- 去
https://go.dev/dl/下载go1.21.6.linux-amd64.tar.gz（Linux）或对应平台包，解压到/usr/local/go或$HOME/sdk/go1.21.6 - GoLand 中进入 Settings → Go → GOROOT，手动指定该解压路径（不是系统自带的
/usr/bin/go） - 确认 Project SDK 已切换为该版本，且
go version在终端中输出含go1.21.6
注意：不要依赖 GoLand 自动探测的 SDK，它常误选系统旧版；每次升级 Go 后，必须手动更新 GOROOT 并重载项目。
代理与依赖索引需手动触发刷新
国内开发时，GOPROXY 不生效会导致 go get 卡死、buf 或 protoc-gen-go 安装失败，GoLand 的依赖索引也会停滞，表现为 import 包标红但实际能编译通过。
统一LLM网关 - 一个API对接70+AI模型，使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
必须做两件事：
- 在终端执行：
go env -w GOPROXY=https://goproxy.cn,direct - 在 GoLand 中点击 File → Reload project（不是 “Synchronize”），否则
go.mod变更不会触发 vendor 或缓存重建
验证代理生效：运行 go list -m -f {{.Dir}} golang.org/x/net，应秒级返回路径；若超时，说明代理未穿透到 GoLand 的 shell 环境，需检查 GoLand 终端是否继承了系统 shell 的 env（Settings → Tools → Terminal → Shell path 设为 /bin/zsh 或 /bin/bash）。
proto 文件生成与代码跳转要配 buf 或 protoc 插件
微服务 Gateway 必须处理 gRPC 路由，api/ 下的 .proto 文件若没正确生成 Go 代码，import 会失败，且 GoLand 无法跳转到 service 方法定义。
推荐用 buf（比原生 protoc 更可靠）：
- 安装：
curl -sSL https://github.com/bufbuild/buf/releases/download/v1.32.1/buf-$(uname -s)-$(uname -m) -o /usr/local/bin/buf && chmod +x /usr/local/bin/buf - 在项目根目录放
buf.yaml，内容含version: v1和managed: enabled - GoLand 中安装
Buf Plugin（Marketplace 搜索），启用后右键.proto文件 →Generate Code with Buf
关键点：生成的 gen/ 目录必须在 go.mod 的 replace 或 require 中声明，否则 GoLand 仍视为未 resolve 的 import。
真正麻烦的是跨服务 proto 引用——比如 gateway 引了 user-svc 的 user.proto，但后者不在当前 repo。这时不能靠 GoLand 自动索引，得确保 buf generate 时已把依赖 proto 下载到 buf.lock 并正确映射路径，否则跳转和补全全失效。
