goland需配置protoc、插件路径及gopath/bin环境变量，否则kratos new生成项目会缺失.pb.go或wire_gen.go致编译失败；须在终端验证which protoc与which protoc-gen-go，启用wire插件并标记wire_gen.go为generated sources root，调试时应直接运行main.go而非kratos run。
GoLand 本身不内置 Kratos 支持，但能高效配合 Kratos 工作——关键在于配置好 protoc、插件路径和 GOPATH/bin 环境变量，否则 kratos new 生成的项目会缺 .pb.go 文件或 wire_gen.go，直接导致编译失败。
protoc 和 protoc-gen-* 插件必须在 GoLand 终端里可执行
Kratos 依赖 protoc 编译 .proto 文件，而 GoLand 的内置终端默认不继承系统 PATH（尤其 Windows/macOS GUI 启动时）。常见现象是：命令行能跑通 protoc --version，但在 GoLand Terminal 里报 command not found。
- Windows：在 GoLand → Settings → Tools → Terminal → Shell path，设为
cmd.exe或powershell.exe，并确保protoc和protoc-gen-go所在目录已加入系统环境变量PATH - macOS/Linux：GoLand 默认用 zsh/bash，但可能未加载
~/.zshrc。在 Settings → Tools → Terminal → Shell path 中填完整路径，例如/bin/zsh -i（-i表示交互模式，会加载配置） - 验证方式：在 GoLand Terminal 中运行
which protoc和which protoc-gen-go，两个都应返回有效路径；再试protoc --plugin=protoc-gen-go=$(which protoc-gen-go) -I. api/helloworld/v1/greeter.proto --go_out=. --go-grpc_out=.，不报错即通
GoLand 必须识别 wire 生成的依赖注入代码
wire.go 是 Kratos 项目启动入口，但 GoLand 默认不自动运行 wire，也不会把 wire_gen.go 当作源码参与分析——这会导致跳转不到 InitializeApp、类型推导失效、甚至标红 app := wire.NewApp(...)。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 先手动在项目根目录运行
go run github.com/google/wire/cmd/wire，确认生成了cmd/server/wire_gen.go - 在 GoLand 中右键点击
wire.go→ “Run Wire”（需提前安装 Wire 插件：Settings → Plugins → 搜索 “Wire” 并启用） - 若无 Wire 插件，可在 Settings → Go → Build Tags & Vendoring → Build Tags 中添加
wire，并勾选 “Reload project after changes”，让 GoLand 主动 watchwire.go - 生成后，右键
wire_gen.go→ “Mark as Generated Sources Root”，否则 GoLand 不会索引其中的函数定义
GoLand 调试 Kratos 服务要绕过 kratos run 封装
kratos run 是一个封装命令，它会监听文件变更、自动 rebuild、注入调试参数——但 GoLand 的 Debugger 无法 attach 到这种动态进程，断点全失效。直接 debug main.go 又会因 conf.Load() 找不到 configs/config.yaml panic。
- 不要用
kratos run启动调试，改用 GoLand 的 “Edit Configurations” → “Go Build” → Program path 填cmd/server/main.go，Working directory 设为项目根目录（即含configs/的路径） - 在 “Program arguments” 中加
-conf ./configs，与main.go中flag.StringVar(&confPath, "conf", "./configs", "config path")对齐 - 若用 Makefile（如
make build && ./bin/server -conf ./configs），可在 GoLand 中新建 “Compound” 配置，先 run make，再 attach debugger - 注意：Kratos 的
log默认输出到 stdout，GoLand Console 能完整捕获；但若启用了fluentd或远程日志，需额外配log.WithWriter(os.Stderr)方便调试
最易被忽略的是 protoc-gen-go-http 和 protoc-gen-go-errors 这类 Kratos 特有插件——它们不参与 go mod tidy，也不在 go.sum 里，但缺失会导致 api/ 下的 *_http.pb.go 和 error_reason.pb.go 为空。每次换机器或重装 GoLand，第一件事不是开项目，而是先跑一遍所有 go install 命令补全插件。
