要在GoLand中调试Gin项目，需先执行go mod tidy确保依赖正确加载，再配置Go Build运行配置并设置GIN_MODE=debug，最后在路由处理函数设断点并通过HTTP请求触发调试。
要在GoLand中对Gin框架项目进行断点调试，必须让调试器能正确加载模块依赖、识别main包入口、并接管HTTP请求生命周期——否则断点不命中、变量无法查看、甚至服务根本起不来。
确认项目已启用Go Modules并完成依赖拉取
打开终端，进入项目根目录，执行 go mod graph | grep gin；若无输出或报错“no required module provides package”，说明gin未被当前模块识别。
运行 go mod tidy 强制补全依赖并下载；该命令会自动写入 go.mod 和 go.sum，【缺少这步会导致GoLand完全无法解析gin.Context等核心类型】。
检查 go.mod 文件末尾是否含类似行：github.com/gin-gonic/gin v1.10.0；若版本号为空或为 // indirect，需手动删掉整行再跑一次 go mod tidy。
在GoLand中配置可调试的Run Configuration
点击右上角「Add Configuration」→「+」→ 选择「Go Build」。
填写以下三项必填字段：
• Name：任意命名（如「Debug Gin Server」）
• Run kind：选「Package」
• Package path：输入 ./（表示当前目录下含main函数的包）
取消勾选「Allow parallel run」——Gin默认监听8080端口，重复启动会因端口占用直接panic，且调试器无法接管第二次启动。
在「Environment variables」栏添加：GIN_MODE=debug；这能让Gin输出更详细的错误堆栈，【不加此变量时panic仅打印一行，断点停住也看不出上下文】。
设置并触发HTTP请求断点
在 r.GET("/xxx", func(c *gin.Context) { ... }) 匿名函数第一行左侧灰色区域单击，设断点；GoLand会显示红色圆点。
点击右上角绿色虫子图标（Debug）启动；控制台输出 [GIN-debug] Listening and serving HTTP on :8080 后，用浏览器或curl访问对应路由，例如：curl "http://localhost:8080/ping"。
此时代码会在断点处暂停，鼠标悬停可查看 c.Request.URL.Path、c.Param("id") 等值；展开 c 可逐层查看Header、Query、Form数据——【注意：c.PostForm()和c.GetPostForm()行为不同，前者空值返回空字符串，后者返回string+bool，调试时务必用后者判断是否存在】。
调试JSON参数绑定失败问题
方法一：在结构体定义处设断点
在 type User struct { Name string `json:"name"` } 声明行设断点，运行后观察结构体字段是否被正确识别；若字段名首字母小写，断点停住时值恒为零值，且 c.ShouldBindJSON() 必然失败。
方法二：在绑定调用后立即检查error
在 if err := c.ShouldBindJSON(&u); err != nil { 这行设断点，F8单步进；若err非nil，展开看具体是 json: cannot unmarshal string into Go struct field User.Age of type int 还是 Key: 'User.Name' Error:Field validation for 'Name' failed on the 'required' tag。
方法三：临时改用Query参数验证路由通路
把 c.ShouldBindJSON(&u) 换成 name, ok := c.GetQuery("name")，在ok为false时设条件断点：右键断点 →「More」→ 勾选「Condition」→ 输入 !ok；这样只在参数缺失时中断，避免每次请求都停。
