buffalo纯api开发核心是卸载全栈默认配置：删templates/assets目录、禁用cookies/csrf中间件、移除servefiles、统一用c.json输出；路径参数用c.param()、查询参数用c.queryparam()或c.request().url.query()；header必须通过c.request().header.get()读取，且注意body只能读一次。
Buffalo 项目开发接口，核心不是“怎么写 handler”，而是“怎么避开全栈默认配置的干扰”——buffalo new --api生成的骨架仍带模板、asset、session、CSRF 等非 API 必需组件，不清理会拖慢响应、暴露安全风险、增加调试成本。
用 buffalo new --api 初始化后必须精简
生成的项目默认包含 templates/、assets/、cookies、CSRF 中间件等，纯 API 场景下它们全是冗余：
- 删掉
templates/和assets/目录（连同webpack.config.js、package.json） - 注释或删除
app.Use(cookies.Secure())、app.Use(csrf.New())—— 这些依赖 Cookie 和表单，API 通常走 token 认证 - 移除所有
app.ServeFiles(...)调用，避免静态文件路由污染 API 路径 - 确认
app.JSON或c.Render(200, r.JSON(...))是唯一输出方式，禁用r.HTML和模板引擎加载逻辑
c.Param() 和 c.QueryParam() 别混用
路径参数（如 /users/:id）必须用 c.Param("id")，它从路由定义中提取；查询参数（如 ?page=2）才用 c.QueryParam("page")。两者底层来源不同，混用会导致取不到值：
Buffalo框架 1.0.1
下载
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
-
c.Param("id")返回空字符串（不是nil），需手动转类型：id, err := strconv.ParseUint(c.Param("id"), 10, 64) -
c.QueryParam("sort")等价于c.Request().URL.Query().Get("sort")，适合分页、排序、过滤类参数 - 若需批量读取查询参数，直接用
c.Request().URL.Query()得到url.Values，再调用GetAll()或遍历
Header 读取必须走 c.Request().Header.Get()
Buffalo 的 c 上下文不提供 Header 方法，常见错误是试图调用 c.Header.Get() 或 c.GetHeader() —— 这些方法根本不存在：
- 正确方式：先
c.Request()拿到原始*http.Request，再.Header.Get("Authorization") - Header 名大小写不敏感，但建议统一用首字母大写格式（如
"X-Request-ID"） - 多值 header（如
"X-Forwarded-For"）要用.Values()取切片，.Get()只返回第一个值（逗号拼接） - 中间件里读不到 header？检查是否已有中间件提前读取了
c.Request().Body—— body 只能读一次，后续再读会返回空
Session 和加密传输不是 API 的事
纯 API 接口不该依赖 c.Session()，也不该在 handler 里对响应体做 AES/Base64 加密：
-
c.Session().Set()+c.Session().Save()是为浏览器会话设计的，API 通常用 JWT 或 Bearer Token，session 机制反而引入状态和扩展瓶颈 - 所谓“接口加密传输”，本质是 TLS 层的事 —— 必须由 Nginx 终止 HTTPS 或用
http.ListenAndServeTLS启动，不是在c.JSON()前套一层加密函数 - 如果真要字段级脱敏（如手机号显示为
138****1234），在 handler 里手动处理结构体字段即可，别碰传输层
真正卡住人的地方，往往不是写 handler，而是没意识到 Buffalo 默认生成的是全栈骨架 —— 它的中间件链、模板系统、asset 构建流程，在 API 场景下不是“可选”，而是“必须主动卸载”。否则你写的每个 c.JSON() 都在为不需要的功能买单。
