gin无需全局安装，go get失败主因是goproxy未设为国内镜像；default()自动加载logger和recovery中间件，new()为空引擎；端口冲突需显式指定；c.json()已自动设content-type；context非线程安全，不可跨goroutine使用。
gin 框架本身不需“全局安装”，它只是 Go 项目的一个依赖模块——只要 go mod 正常工作，go get 就能拉下来用。国内用户卡在 go get 失败，基本都是代理没设对，不是 Gin 本身的问题。
为什么 go get github.com/gin-gonic/gin 总是超时或报错？
这不是 Gin 的锅，而是 Go 默认代理 proxy.golang.org 在国内不可达。错误信息常见：cannot find module providing package github.com/gin-gonic/gin 或 Get "https://proxy.golang.org/...": dial tcp: i/o timeout。
- 必须提前设置
GOPROXY环境变量，推荐值：https://goproxy.cn,direct（七牛云镜像，稳定且同步及时） - Windows CMD 执行：
set GOPROXY=https://goproxy.cn,direct - macOS/Linux 执行：
export GOPROXY=https://goproxy.cn,direct（建议写入~/.zshrc或~/.bash_profile） - 验证是否生效：
go env GOPROXY应输出https://goproxy.cn,direct - 设完立刻重试，不用重启终端（但新终端需重新 source）
gin.Default() 和 gin.New() 有什么实际区别？
别只记“Default 更方便”，关键看默认行为是否符合你当前场景：
-
gin.Default()自动加载两个中间件：Logger()（打印请求日志）和Recovery()（panic 捕获，防止服务崩溃） -
gin.New()是空引擎，什么中间件都不带——适合测试、CLI 工具集成、或你明确要自己控制日志/panic 处理逻辑 - 开发阶段用
Default()能快速看到请求流；生产环境若已有统一日志系统，反而该用New()避免重复打日志 - 两者创建后，路由注册方式完全一样：
r.GET(...)、r.POST(...)
启动服务时端口被占用或监听失败怎么办？
router.Run() 默认监听 :8080，但实际部署中容易踩坑：
- 不传参数时等价于
router.Run(":8080")，绑定的是0.0.0.0:8080—— 如果本地已有进程占了 8080，会报错：listen tcp :8080: bind: address already in use - 想换端口，直接传字符串：
router.Run(":3000")或router.Run("127.0.0.1:8080") - 想监听所有 IPv6 接口？用
[::1]:8080，但注意某些防火墙会拦截 - 开发时建议显式指定端口，避免依赖默认值；CI/CD 中应从环境变量读取，比如：
router.Run(":" + os.Getenv("PORT"))
为什么 c.JSON(200, ...) 返回的响应头没有 Content-Type: application/json？
它其实有——c.JSON() 内部已自动设置。但如果你手动用了 c.Data() 或 c.String() 后再试图补头，就可能出问题：
-
c.JSON()、c.XML()、c.YAML()这类方法会自动设置对应Content-Type，无需额外调用c.Header() - 错误写法：
c.Header("Content-Type", "application/json"); c.String(200, `{"a":1}`)—— 这会导致响应体是纯文本，但头说它是 JSON，前端解析会失败 - 正确做法：要么全用
c.JSON()，要么全手动控制：c.Data(200, "application/json", []byte(`{"a":1}`)) - 调试时可用
curl -v http://localhost:8080/ping查看真实响应头，别只信浏览器开发者工具的“Preview”
Context 对象不是线程安全的，不能跨 goroutine 传递（比如在 go func() { ... }() 里直接用 c）。一旦涉及异步处理，必须显式拷贝需要的数据，否则会 panic 或返回脏数据。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
