Gin静态文件404主因是路径映射严格依赖当前工作目录，需用filepath.Abs确保绝对路径或embed.FS配合StaticFS；避免相对路径、尾部斜杠及路径结构不匹配。
静态文件404？检查 StaticFS 路径是否相对于可执行文件
Gin 默认不自动查找项目根目录下的 static 文件夹，它只认当前工作目录（即你运行 go run 或二进制时所在的目录）。如果你把二进制放到其他路径执行，./static 就会失效。
- 推荐用绝对路径：用
filepath.Abs("static")获取真实路径，再传给gin.StaticFS - 不要写成
router.Static("/static", "./static")—— 这在 Docker 或 systemd 下极易 404 - 如果用
embed打包静态资源（Go 1.16+），必须搭配gin.StaticFS+http.FS，不能直接用Static
router.Static 和 router.StaticFS 到底该用哪个？
router.Static 是快捷封装，仅支持本地磁盘路径；router.StaticFS 更底层，支持任意 http.FileSystem 实现（比如 embed.FS、os.DirFS、自定义 FS）。
- 开发期快速起效：用
router.Static("/assets", "public") - 生产打包进二进制：必须用
router.StaticFS("/assets", http.FS(assetsFS))，其中assetsFS是embed.FS变量 -
Static内部调用了http.Dir，不支持嵌入式文件系统；硬用会 panic：“invalid filesystem”
路由前缀和文件系统路径不匹配导致 403 或空白响应
常见错误是把 URL 前缀（如 /static）和文件系统路径（如 ./dist）混为一谈。Gin 不会自动映射子目录，它只做“前缀剥离 + 路径拼接”。
- 写
router.Static("/static", "./dist")后，访问/static/js/app.js会尝试读取./dist/js/app.js - 如果实际文件在
./dist/static/js/app.js，那就要写成router.Static("/static", "./dist/static") - 浏览器请求
/favicon.ico时，Gin 会按规则查找./dist/favicon.ico—— 注意根目录下是否真有这个文件
嵌入静态资源后 CSS/JS 404？确认 go:embed 模式是否覆盖目标文件
go:embed 默认不递归匹配子目录，且区分大小写、忽略隐藏文件（以 . 开头），很容易漏掉资源。
立即学习“go语言免费学习笔记（深入）”；
- 正确写法：
//go:embed dist/**（双星号才递归）或//go:embed dist/*（单层） - 检查 embed 变量类型是否为
embed.FS，不是string或[]byte - 用
fs.WalkDir在启动时打印所有嵌入路径，验证dist/css/main.css是否在列表里 - 避免在
dist里放.gitignore或README.md—— 它们不会被 embed，但可能干扰你的本地测试逻辑
curl -I /static/test.txt 验证路径是否通。 
