router.GET不生效的首要原因是未调用router.Run()启动服务，导致路由定义后程序直接退出；必须显式调用router.Run()（默认:8080）才能监听端口，端口冲突时需更换或释放端口。
为什么 router.GET 不生效？检查是否漏掉 router.Run()
Gin 路由不响应请求，最常见的原因是启动服务这一步被跳过。定义好 router.GET 之后，必须显式调用 router.Run()（或 router.RunTLS、router.RunUnix）才能监听端口。没有它，程序就只是定义了路由表，然后直接退出。
-
router.Run()默认监听:8080，可传入字符串如":3000"指定端口 - 如果端口被占用，会报错
listen tcp :8080: bind: address already in use，需换端口或杀进程 - Windows 下若提示
permission denied，可能是端口
如何给多个路径注册相同处理函数？用 router.Any() 或链式调用
不需要为 GET、POST 等方法重复写同一逻辑时，别手动复制 handler。Gin 提供 router.Any() 注册全方法路由；更推荐的是链式调用 router.Handle() 显式声明支持的方法。
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
-
router.Any("/health", healthHandler)接收所有 HTTP 方法，适合探针接口 -
router.Handle("GET,POST", "/api/data", dataHandler)更明确，避免意外接受不安全方法 - 注意：
router.POST()和router.Handle("POST", ...)行为一致，但后者便于批量注册
带参数的路由怎么写？路径段用 :name，通配段用 *name
Gin 的路径参数分两种：命名段（:id）匹配单个路径片段，通配段（*filepath）匹配剩余全部路径。二者不能混用在同一路径中，否则 panic。
- 正确：
router.GET("/user/:id", func(c *gin.Context) { id := c.Param("id") }) - 正确：
router.GET("/static/*filepath", staticHandler)——c.Param("filepath")返回/js/app.js（含开头斜杠） - 错误：
"/user/:id/*rest"会导致启动时报invalid pattern - 若需校验
:id是数字，应在 handler 内手动strconv.Atoi，Gin 不做自动类型转换
静态文件服务为什么返回 404？确认路径和 router.StaticFS 参数顺序
用 router.Static() 或 router.StaticFS() 时，第一个参数是 URL 前缀（如 /assets），第二个是本地文件系统路径（如 "./public"）。顺序反了或路径不存在，都会导致 404，且无明显错误提示。
-
router.Static("/static", "./static")：访问/static/logo.png对应磁盘./static/logo.png - 若本地路径是相对路径，确保程序工作目录正确（建议用
os.Executable()+filepath.Dir定位） -
router.StaticFS("/data", http.Dir("/tmp/uploads"))可暴露绝对路径，但注意权限和安全性 - 开发时建议加
router.Use(gin.Logger())查看实际请求路径和响应状态码
