router.static()是最常用且推荐的静态资源托管方式，自动处理mime类型、etag缓存、路径安全校验；需注意运行时工作目录而非源码目录，避免404； favicon.ico等单文件应使用staticfile()显式注册。
router.Static() 是最常用且推荐的配置方式
直接用 router.Static() 就能完成 90% 的静态资源托管需求，比如图片、CSS、JS。它内部自动处理 MIME 类型推断、缓存头（ETag 和 If-Modified-Since）、路径安全校验（防止 ../ 跳出目录），不需要额外中间件或包。
常见错误现象：前端请求 /img/logo.png 返回 404，但文件明明存在 —— 很可能是本地路径写错，或没注意 Go 工作目录是执行 go run 命令时的当前路径，不是 main.go 所在目录。
- 确保本地目录路径是相对于**运行时工作目录**，不是源码目录；调试时可用
os.Getwd()打印确认 -
router.Static("/img", "./img")表示：所有以/img/开头的请求，从当前目录下的./img/查找对应文件 - 支持子目录嵌套，例如
/img/icons/arrow.svg会映射到./img/icons/arrow.svg - 不要在路径末尾加斜杠：
"/img/"是错的，应写成"/img"
StaticFS 适合需要控制文件系统行为的场景
当你想用 embed.FS 编译进二进制、或挂载到只读存储（如 /var/www/uploads）、或禁用目录列表时，必须用 router.StaticFS()。它接收 http.FileSystem 接口，比 Static() 更底层、更灵活。
容易踩的坑：直接传 http.Dir("/path") 会导致访问 /assets/（结尾带斜杠）时返回目录列表 —— 这在生产环境属于信息泄露风险。
- 用
http.FS(embed.FS)+fs.Sub()剥离前缀，才能正确映射嵌入资源 - 若必须用
http.Dir，建议包装一层避免目录列表，例如：http.StripPrefix("/uploads", http.FileServer(http.Dir("/var/www/uploads"))) -
StaticFS不做路径安全校验，需自行确保传入的FileSystem不暴露敏感路径
别用 gin-contrib/static 中间件
第三方 gin-contrib/static 包早已过时，Gin 官方自 v1.3 起就内置了完整静态服务能力。router.Use(static.Serve(...)) 写法不仅冗余，还可能和 router.Static() 冲突，导致重复注册或路由优先级混乱。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
典型症状：同一张图片有时能加载、有时 404；或者 /css/style.css 正常，但 /img/logo.png 报 403 —— 很可能是两个静态中间件对同一路径前缀做了不同处理。
- 删除
import "github.com/gin-contrib/static"及所有Use(static.Serve(...))调用 - 统一改用
router.Static()或router.StaticFS() - 如果项目用了旧教程或模板，务必检查是否有残留的
gin-contrib/static引用
单文件如 favicon.ico 应该用 StaticFile
对于 /favicon.ico、/robots.txt 这类固定路径、固定内容的文件，router.StaticFile() 是最轻量、最明确的选择。它不走目录查找逻辑，直接绑定一个文件到指定 URL 路径，性能好且语义清晰。
错误做法：把 favicon.ico 放进 ./img/ 目录，再用 router.Static("/img", "./img") 暴露 —— 这会让 /favicon.ico 无法被浏览器自动发现（浏览器只认根路径的 /favicon.ico）。
- 必须显式注册：
router.StaticFile("/favicon.ico", "./resources/favicon.ico") - 路径必须是完整 URL 路径，不能是前缀；第二个参数必须是绝对或相对文件路径（运行时视角）
- 多个
StaticFile调用无冲突，但不要和Static映射同一路径前缀（如都覆盖/assets）
真正容易被忽略的是工作目录和构建环境的差异：本地开发时 ./img 没问题，但 Docker 构建时若没把 img/ 目录 COPY 进镜像，或用了 embed.FS 却忘了 go:embed 指令的路径匹配规则，就会静默失败。上线前务必验证静态路径是否真实可访问，而不是只看 HTML 里 src 写得对不对。
