GoLand 调试 Macaron 需用 go build 生成带符号的二进制，再通过 Go Build 运行配置启动；断点仅在 HTTP 请求到达时触发中间件，需配合 GoLand HTTP Client 发送请求验证。
GoLand 本身不内置对 Macaron 框架的专用调试支持，但能通过标准 Go 运行配置 + 断点 + dlv 调试器完成完整调试流程。关键不在“Macaron 专属配置”，而在确保 GoLand 启动的是你本地可调试的二进制（非 go run），且调试器能正确 attach 到进程。
Macaron 项目必须用 go build 启动才能调试
Macaron 默认常被写成 go run main.go 启动，但这会导致 GoLand 无法注入调试器 —— dlv 需要调试一个已编译、带 DWARF 符号的可执行文件。直接运行源码时，dlv 会报错：could not launch process: stub exited while waiting for connection 或静默失败。
实操建议：
- 在项目根目录下执行
go build -o ./bin/server .（确保main.go在当前目录或cmd/下） - GoLand 中新建 Run Configuration → 选择
Go Build类型 -
Run kind设为Package，Package path填.（或具体cmd/server） -
Output directory设为./bin，Output file设为server - 勾选
Allow running in background（避免终端窗口抢占焦点）
调试时 Macaron 的 m.Use() 中间件可能跳过断点
Macaron 的中间件注册是链式调用（如 m.Use(logger())），但实际执行发生在请求进入时。你在 logger() 函数首行打的断点，只有在真实 HTTP 请求到达后才会触发 —— 不是程序启动就停住。
常见错误现象：
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 点击 Debug 按钮后控制台输出 “Server started on :3000”，但断点没命中
- 误以为断点失效，其实是还没发请求
正确做法：
- 先启动 Debug 配置（服务跑起来）
- 用
curl http://localhost:3000/health或 GoLand 内置 HTTP Client 发请求 - 此时才会进入中间件函数，断点生效
- 若仍不触发，检查该中间件是否被
m.Group()或路由条件过滤掉
GoLand HTTP Client 配合 Macaron 路由调试更高效
Macaron 路由定义清晰（如 m.Get("/api/user/:id", getUser)），但手动 curl 容易漏头、拼错路径。GoLand 的 HTTP Client 插件可直接在 .http 文件里写请求，并复用 OpenAPI 文档（如果项目有）。
使用场景：
- 测试带 path 参数的路由（
:id、*） - 验证 header、cookie、JSON body 是否被中间件或 handler 正确解析
- 对比不同环境（dev/staging）返回差异
操作要点：
- 新建
debug.http文件，写入：GET http://localhost:3000/api/user/123 Accept: application/json
- 右键 →
Send Request，响应体自动展开 - 若 Macaron 启用了
m.Use(macaron.Logger())，可在 GoLand Console 看到结构化日志输出，和断点变量一起交叉验证
Macaron 本身轻量，没有像 Gin 那样深度集成 IDE 调试提示，所以容易忽略“必须 build 后调试”这个前提；另外它的中间件执行时机完全依赖请求触发，不是启动即运行 —— 这两点是新手最容易卡住的地方。
