http.FileServer 默认不支持 index.html 自动查找和目录索引，仅严格路径匹配，故访问 / 返回 404；需手动包装 ServeMux、StripPrefix、使用绝对路径，并自行实现 fallback 或索引逻辑。
为什么 http.FileServer 直接用会 404？
默认情况下，http.FileServer 不会自动查找 index.html —— 它只做严格路径匹配。比如访问 /，它不会去读取根目录下的 index.html，而是直接返回 404。
常见错误现象：curl http://localhost:8080/ 返回 404，但 curl http://localhost:8080/index.html 能正常返回。
- 必须显式包装一层
http.ServeMux并注册"/"路径 - 用
http.StripPrefix去掉 URL 前缀，否则文件系统路径会多出一级（比如请求/static/js/app.js，却去读./static/static/js/app.js） - 传给
http.FileServer的http.Dir必须是绝对路径，相对路径在某些工作目录下会失效
如何让 http.FileServer 支持目录索引和默认页
Go 标准库不内置目录列表功能，也不自动 fallback 到 index.html；要支持这两者，得自己补逻辑。
使用场景：本地开发预览、CI 构建产物临时托管、内网文档服务。
立即学习“go语言免费学习笔记（深入）”；
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 启用目录索引：把
http.Dir包进http.FileSystem实现，并重写Open方法，在打开目录时返回index.html（如果存在） - 更稳妥的做法是用
http.FileServer+http.NotFoundHandler组合：先尝试原路径，失败后手动检查index.html - 注意：开启目录索引有安全风险，生产环境应禁用（设
fs := http.Dir(".").Open返回nil或加白名单）
http.FileServer 在 Windows 和 macOS 下的路径陷阱
Windows 默认用反斜杠 ，而 http.FileServer 内部用正斜杠 / 解析 URL 路径，两者混用会导致 Open 失败或路径穿越漏洞（如 ..%5C..%5Cetc%5Cpasswd）。
性能影响：路径校验逻辑在每次请求都执行，不规范的 Dir 初始化会放大开销。
- 始终用
filepath.ToSlash(filepath.Abs("./public"))构造http.Dir参数 - 避免直接传
"./public"或"public\"—— 这些在跨平台构建时极易出错 - 若需限制访问范围，用
http.Dir包裹前先做路径规范化和白名单校验（比如禁止含".."）
什么时候不该用 http.FileServer？
它适合快速启动、无动态逻辑、无鉴权、无缓存控制需求的场景。一旦涉及以下任一条件，就该换方案或加中间层。
- 需要按用户角色控制文件可见性（比如 /admin/* 只对登录用户开放）
- 要求强制
Cache-Control: public, max-age=31536000但又不想手动写 header - 静态资源分散在多个目录（如
dist/+uploads/），http.FileServer不支持多 root - 前端用了 SPA，需要所有非 API 路径 fallback 到
index.html（这时得自己写 handler 拦截 404）
最常被忽略的一点：它不处理 Range 请求（断点续传、视频拖拽），浏览器播放大文件时可能卡顿或失败。真要支持，得自己实现 http.Range 解析和分片响应。
