直接运行 go run main.go 看不到 gin 调试信息，是因为 gin_mode 被设为 release 或代码中调用了 gin.setmode(gin.releasemode)；gin 在 release 模式下静默所有日志，包括路由注册、中间件和请求详情。
直接运行 go run main.go 为什么看不到 Gin 的调试信息？
Gin 默认在开发模式下会打印路由注册日志、中间件执行顺序和 HTTP 请求详情，但如果你用 go run main.go 启动后终端没输出任何 Gin 相关日志，大概率是因为环境变量 GIN_MODE 被设成了 release 或项目里手动调用了 gin.SetMode(gin.ReleaseMode)。Gin 在 release 模式下会静默所有调试输出，连 404 错误都不会打到终端。
解决方法很简单：启动前确保环境变量正确：
- 临时设置：
GIN_MODE=debug go run main.go（macOS/Linux）或set GIN_MODE=debug && go run main.go（Windows cmd） - 更稳妥的做法是在 VSCode 的调试配置里统一指定，避免每次手动输
- 检查代码里有没有硬编码的
gin.SetMode(...)，尤其在init()或main()开头
VSCode 调试配置必须包含哪些关键字段？
VSCode 的 Go 调试依赖 .vscode/launch.json，对 Gin 项目来说，光有默认的 dlv 配置不够，容易卡在启动阶段或断点不命中。核心字段缺一不可：
-
name：随便起，但建议带Gin关键词，方便快速识别 -
type：固定为go -
request：必须是launch（不是attach） -
mode：必须是auto或exec（推荐auto，它会自动选exec或test） -
program：指向入口文件，如${workspaceFolder}/main.go，不能是目录 -
env：必须显式加入"GIN_MODE": "debug"，否则调试器启动的进程仍走 release 模式 -
args：如有命令行参数（比如配置文件路径），放这里，不要塞进program
示例最小可用配置：
{
"version": "0.2.0",
"configurations": [
{
"name": "Launch Gin",
"type": "go",
"request": "launch",
"mode": "auto",
"program": "${workspaceFolder}/main.go",
"env": {
"GIN_MODE": "debug"
}
}
]
}
断点不触发？检查这三个地方
Gin 是基于 HTTP handler 的框架，断点写在 router.GET("/xxx", handler) 的 handler 函数里才有效；写在 main() 末尾或 router.Run() 后面基本没意义——因为那之后程序就阻塞在 HTTP server 循环里了，不会继续往下走。
- 确认断点位置在实际被请求触发的 handler 内部，比如
func handleUser(c *gin.Context) { ... } - 确认你发起的是真实 HTTP 请求（用 curl、Postman 或浏览器访问
http://localhost:8080/xxx），而不是只点了 VSCode 的「开始调试」就以为该断了 - 检查
router.Run()是否传了端口，比如router.Run(":3000")，那么你要访问:3000，不是默认的:8080；VSCode 调试器不会自动帮你改端口
另外，如果 handler 里用了 goroutine（比如 go func() {...}()），断点要放在 goroutine 内部，外部的断点不会等它。
热重载不起作用？别指望 VSCode 自带调试器能 reload
VSCode 的 dlv 调试器本质是启动一个进程并 attach，它本身不支持文件变更后自动重启。你改了代码、保存、再点「重新启动调试」，中间有几秒空白期，HTTP 请求会 502 或超时——这不是配置错了，是设计如此。
- 真正实现 Gin 项目热重载，得靠第三方工具，比如
air：go install github.com/cosmtrek/air@latest，然后在项目根目录运行air - 若坚持用 VSCode 调试，可以配合
air的调试模式：先用air -c .air.toml启动，并在配置中启用port（如port = 2345），再在launch.json中把mode改成attach，port设为2345 - 注意：用
attach模式时，program字段失效，dlv会连接已运行的进程，断点必须在 attach 前就打好
多数人卡在这一步，以为 VSCode 本该支持保存即生效，其实它只负责调试，不负责构建和重启。
