必须先安装buffalo cli，否则buffalo g resource等命令会报command not found；该命令内置在cli中，不依赖项目目录或go.mod，需确保$gopath/bin在path中且go≥1.21。
buffalo g resource 命令必须先装 CLI 才能运行
没装 buffalo 二进制，直接跑 buffalo g resource 会报 command not found——这不是项目问题，而是系统根本找不到这个命令。
Buffalo 的所有生成器（g resource、g action、g migration）都内置在 buffalo CLI 里，不是独立工具，也不依赖当前项目目录或 go.mod。装完就能在任意路径用。
- 正确安装方式是：
go install github.com/gobuffalo/cli/cmd/buffalo@latest - 装完必须验证：
which buffalo有输出，且buffalo version能打印版本号 - 常见失败点：PATH 没包含
$GOPATH/bin；Go 版本低于 1.21；终端没新开（PATH 不刷新）
生成资源时字段定义要写对，否则迁移和模型会出错
buffalo g resource users name:string email:string 这类命令里，字段语法必须是 name:type 格式，中间不能有空格，类型名必须是 pop 支持的（如 string、int、bool、time），拼错或用错类型会导致生成的迁移文件无效。
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
- 错误示例：
buffalo g resource posts title: string（冒号后多空格 → 字段被忽略） - 错误示例：
buffalo g resource posts status:enum（pop 不识别enum，得用string+ 应用层校验） - 生成后务必检查
models/migrations/下的 fizz 文件，确认字段已正确定义 - 如果字段漏了，别手动改迁移——重跑
buffalo g resource不会覆盖已有文件，得先buffalo destroy resource users再重试
生成后必须立即执行 buffalo db migrate，否则运行时报 table not found
buffalo g resource 只生成迁移文件，不执行它。如果你跳过这步就直接 buffalo dev，启动时 app.Pop() 尝试查 users 表会 panic，错误信息类似 relation "users" does not exist，但不会明确告诉你该去跑 migrate。
- 顺序不能乱：先
buffalo db create（建库），再buffalo db migrate（建表） - 确保
database.yml的development区块配置正确，或更稳妥地设环境变量DB_URL=postgres://... - 如果
buffalo db migrate报错，先看是不是models/models.go里漏注册了新模型（PopMap 缺少对应项） - 迁移成功后，可跑
buffalo db shell进 psql，执行\dt确认表已存在
resource 生成的代码默认带模板和中间件，纯 API 场景要手动清理
你跑 buffalo g resource api/v1 users 并不等于得到一个干净的 JSON API；它仍会生成 HTML 模板、挂载 session/CSRF/transaction 中间件，并默认用 c.Render 返回 HTML。前端调用 POST 会卡在 CSRF 校验，c.JSON 可能被模板中间件拦截报 template "users/index.html" is undefined。
- 删掉
templates/users/整个目录（不然中间件仍尝试找模板） - 注释或删除
app.Use(session.Middleware)和app.Use(csrf.Middleware)（在app.go或config/buffalo-app.go） - 把
actions/users.go里所有c.Render(...)替成c.JSON(...)，并显式设置状态码（如c.JSON(201, user)） - 别只改返回逻辑——中间件链还在，无用的 DB 事务开启、session 初始化仍会执行，影响性能
最易被忽略的是中间件残留：哪怕你删光模板、改全 c.JSON，只要 csrf.Middleware 还在 app.Use() 链里，所有非 GET 请求就会 403。检查 app.go 是第一件事。
