http.fileserver可快速启动静态文件服务，但需注意路径映射、目录列表与默认页支持、http头配置及部署前路径/权限/反代三核查。
用 http.FileServer 启动最简静态文件服务
Go 自带的 http.FileServer 足够跑一个基础文件服务器，不需要额外依赖。它本质是把本地目录映射成 HTTP 路径，浏览器访问 /xxx.js 就读取 ./static/xxx.js。
常见错误是路径没对齐：比如你希望用户通过 /assets/logo.png 访问 ./public/logo.png，但直接传 ./public 给 http.FileServer，结果请求 /assets/logo.png 会去查 ./public/assets/logo.png —— 多了一层 assets。
- 如果想让根路径
/对应磁盘上./dist目录，就用http.FileServer(http.Dir("./dist")) - 如果想把
/static映射到./public，得套一层http.StripPrefix("/static", ...)，否则请求/static/main.css会被当成去读./public/static/main.css -
http.Dir要求路径存在且可读，启动时不会报错，但首次请求 404 或 403 才暴露问题
处理目录列表、隐藏文件和默认页
http.FileServer 默认不显示目录列表（返回 404），也不自动找 index.html —— 这不是 bug，是设计选择。要开目录列表，得自己包装 handler；要支持默认页，得用 http.ServeFile + 判断逻辑，或改用第三方如 github.com/gorilla/handlers。
更实际的做法是：生产环境关掉目录列表，开发时加个简单开关。
- 禁用目录列表：确保目标目录下没有
index.html，且不调用http.Dir的“允许列表”变体（标准库没提供，得自己写） - 启用默认页：用
http.HandlerFunc拦一下，对无后缀路径（如/about）先查/about/index.html，再 fallback 到/about.html - 隐藏
.git、.env类文件：http.FileServer不过滤，得自己实现http.FileSystem接口，跳过以.开头的文件名
HTTP 头、缓存和跨域怎么配
静态资源需要合理设置 Cache-Control，否则每次刷新都重新拉 JS/CSS；前端调试时常要跨域，但 http.FileServer 不处理 CORS。
不能直接给 http.FileServer 加 header，得包一层 handler。
- 加缓存：对
.js、.css等资源设Cache-Control: public, max-age=31536000；HTML 设no-cache防止旧版页面被缓存 - 开跨域：写个中间件，在 response header 加
Access-Control-Allow-Origin: *，注意别在生产环境无条件开 - 禁止上传：
http.FileServer只响应 GET/HEAD，但若你用net/http搭了其他路由，别忘了显式拒绝POST到静态路径，否则可能被利用
上线前必须检查的三件事
本地跑通不等于线上可用。路径、权限、URL 结构这三点最容易在部署后出问题。
- 工作目录是否正确？用
os.Getwd()打印当前路径，确认http.Dir("./static")指向的是你认为的那个目录，而不是二进制所在目录 - 文件权限是否允许读？Linux 下如果用非 root 用户运行，确保
stat ./static显示可读，否则 403 不报具体原因 - 反向代理是否重写了路径？Nginx/Apache 前置时，如果配置了
location /app { proxy_pass http://localhost:8080/; }，那 Go 服务里就得用StripPrefix("/app", ...)，否则所有路径都少一级
真正麻烦的从来不是启动命令写几行，而是路径语义在磁盘、代码、反代、浏览器地址栏之间对不齐。盯住这三处，比背 API 文档管用。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
