gin路由即代码配置，核心是r.get()/r.post()绑定http方法与处理函数，必须调用r.run()启动服务；参数取值分query（url问号后）和param（路径占位符），post/json需用shouldbind或专用方法，分组group统一前缀与中间件。
直接用 r.GET()、r.POST() 这类方法注册就行，不需要额外路由文件或配置中心——Gin 的路由就是代码即配置。
怎么写一个能被访问的接口路由
核心就两步：绑定 HTTP 方法 + 指定处理函数。Gin 不搞 YAML 或 JSON 路由配置，所有路由都在 Go 代码里显式声明。
-
r.GET("/ping", func(c *gin.Context) { c.String(200, "pong") })—— 这行代码一执行，/ping就能被 GET 访问了 - 必须调用
r.Run()启动服务，否则路由不生效（常见错误：写了路由但没r.Run()，浏览器一直连接超时） - 端口默认是
:8080，想换端口直接传参：r.Run(":3000") - 路径末尾不自动补斜杠，
/user和/user/是两个不同路由
GET 请求如何取参数：Query vs Param
URL 中的参数分两类，拿错方式会返回空字符串，且无报错提示。
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
-
/user?id=123→ 用c.Query("id")或c.DefaultQuery("id", "0") -
/user/123（路由定义为r.GET("/user/:id", ...)）→ 必须用c.Param("id") -
c.Query()对 POST 请求也有效（只要 URL 带 ?），但c.Param()只对路径中声明的动态段有效 - 如果路径写成
/user/:id/*action，c.Param("action")会带前导/，得手动strings.Trim(c.Param("action"), "/")
POST/PUT/DELETE 接口怎么接收数据
不能只靠 c.PostForm()，它只解析 application/x-www-form-urlencoded 和 multipart/form-data；JSON 请求必须换方式。
- 表单提交（
Content-Type: application/x-www-form-urlencoded）→ 用c.PostForm("field") - JSON 提交（
Content-Type: application/json）→ 必须用结构体绑定：c.ShouldBind(&req)，或手动读原始数据：data, _ := c.GetRawData() - 上传文件（
multipart/form-data）→ 先c.FormFile("file")，再c.SaveUploadedFile()，注意要提前设r.MaxMultipartMemory -
c.ShouldBind()是通用方案，但会根据Content-Type自动选择解析逻辑，别在 JSON 请求里硬用c.PostForm()
路由分组和版本管理实际怎么写
不要把 v1/v2 写死在每个路由里，用 Group 避免重复前缀和中间件混用。
-
v1 := r.Group("/v1")→ 后续所有v1.GET(...)的路径自动拼上前缀/v1 - 中间件可按组挂载：
v1.Use(authMiddleware)，v2.Use(signVerify)，避免漏加或错加 - 嵌套分组也合法：
api := r.Group("/api"); v1 := api.Group("/v1") - 注意：分组本身不产生路由，
r.Group("/admin")不会响应GET /admin，必须在其下注册具体方法
最易忽略的一点：Gin 的路由树是静态构建的，r.GET() 调用顺序不影响匹配结果，但中间件注册顺序直接影响执行流——分组内 Use() 的位置决定了它是否包裹后续所有 handler。
