gin_mode=debug必须显式设置在run configuration环境变量中，因delve启动早于main执行，os.setenv无效；该模式启用完整上下文注入和堆栈捕获，使c.request、params等字段在调试器中可访问，并提升断点命中率。
为什么GIN_MODE=debug必须显式设置
默认情况下Gin运行在release模式，panic只打印一行错误，gin.Context里的Request、Params等字段在调试器里展开后经常显示<not accessible></not>。这不是IDE问题，是Gin主动屏蔽了调试信息——只有设GIN_MODE=debug才会启用完整上下文注入和堆栈捕获。
-
GIN_MODE=debug必须写在Run Configuration的Environment variables里，不能靠os.Setenv("GIN_MODE", "debug")代码方式设置——Delve启动早于main执行，此时环境变量已冻结 - 若同时用了
gin.SetMode(gin.DebugMode)，它只影响日志输出，不改变调试器可访问字段的可见性 - GoLand 2026.1.1中该变量还影响断点命中率：未设置时，某些中间件链路中的匿名函数断点会直接跳过
如何让c.Request.Body内容在调试时可见
Gin默认把Request.Body读取后就关闭，调试时鼠标悬停看到的是closed body。这不是bug，是HTTP标准行为，但会让排查JSON解析失败变得困难。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 在路由处理函数开头立刻调用
c.Request.Body = http.MaxBytesReader(nil, c.Request.Body, 10*1024*1024)——这不会改变逻辑，但能强制Body保持可读状态直到断点暂停 - 更稳妥的做法是加一层中间件：
r.Use(func(c *gin.Context) { c.Request.Body = io.NopCloser(bytes.NewReader(c.MustGetBody())) })，配合c.ShouldBindJSON(&v)前设断点 - 注意：
c.GetRawData()只能调用一次，第二次返回空切片；调试时优先用c.MustGetBody()再转成bytes.Reader
调试时看不到Query/PostForm参数？检查绑定方式
常见现象：URL带?id=123，但断点处c.Query("id")返回空字符串，c.DefaultQuery("id", "0")也一样。根本原因不是参数没传，而是Gin的解析时机和缓存机制导致调试器无法实时刷新。
- 不要依赖
c.Query()单次调用结果做判断——它内部用c.Request.URL.Query()，而后者在首次调用后会缓存结果。改用c.Request.URL.RawQuery直接看原始字符串 - 表单提交时，
c.PostForm("name")返回空字符串不代表没数据，可能是Content-Type不对（比如发了application/json却用PostForm取）；此时应检查c.Request.Header.Get("Content-Type") - 调试JSON绑定失败，别急着看结构体字段，先在断点处执行
c.GetRawData()——如果返回空切片，说明Body已被其他中间件提前读取
Variables面板里c.Params为空？确认路由定义方式
比如r.GET("/user/:id", handler)，断点里c.Params长度为0，但c.Param("id")能取到值。这是因为Gin把参数存放在两个不同位置：Params数组是原始解析结果，Param()是带缓存的封装方法。
-
c.Params只在路由匹配完成瞬间填充，之后任何中间件或重定向都可能清空它；调试时优先用c.Param("id")而非遍历c.Params - 如果用了
c.Next()进入下一中间件，c.Params会被重置——这是Gin的设计，不是异常 - 嵌套路由如
group := r.Group("/api"); group.GET("/v1/:id", handler)，c.Param("id")仍可用，但c.Params里只含v1段的参数，不含/api前缀
GIN_MODE=debug、用MustGetBody()保Body、查Request.URL.RawQuery和Header.Get("Content-Type")绕过缓存层——这些比翻文档更快定位真实瓶颈。
