Buffalo CLI必须通过go install或预编译包安装，要求Go≥1.21且$GOPATH/bin已加入PATH；安装后需新开终端执行buffalo version验证，否则buffalo new、dev等命令均报command not found。
buffalo CLI 必须用 go install 或预编译包安装
Buffalo 框架本身不提供“组件式安装”概念，所有核心能力都由 buffalo CLI 统一驱动。没装好这个二进制，buffalo new、buffalo dev 全部报 command not found。
必须满足两个前提：
- Go 版本 ≥ 1.21（执行
go version验证） -
$GOPATH/bin已加入系统PATH（执行echo $PATH看是否含该路径）
推荐安装命令是：
go install github.com/gobuffalo/cli/cmd/buffalo@latest
若失败，常见原因有：
- 网络无法访问 GitHub → 改用预编译包：去
https://github.com/gobuffalo/cli/releases下载对应系统的buffalo_*.tar.gz，解压后把buffalo二进制丢进/usr/local/bin并chmod +x - Windows 用户可跳过 Go 环境，直接用 Scoop：
scoop bucket add extras && scoop install buffalo，自动注册 PATH
装完务必新开终端，运行 buffalo version —— 不输出版本号就等于没装上，别往下走。
buffalo-auth 插件不是 npm 包，而是代码生成器
buffalo-auth 不是传统意义上的“组件库”，它不通过 go get 或 npm install 引入，而是一个内置的代码生成逻辑。运行它，会在项目里直接写入 models/user.go、actions/auth.go 和中间件配置。
使用前确保已在项目根目录，且已执行过 go mod tidy（否则生成时可能 panic）：
buffalo generate auth
它会自动做三件事：
- 创建
User模型（含Email、PasswordHash字段）和迁移文件 - 生成
Register、Login、Logouthandler，并注入auth_required中间件 - 配置 session 存储（默认基于 cookie 的加密存储，无需额外初始化）
注意：表单字段名必须严格为 email 和 password；登录成功后，current_user 会自动注入模板上下文，但前提是路由必须被 auth.Required 包裹，否则 auth.CurrentUser(r) 返回 nil。
数据库驱动依赖系统级工具链，不只是 go get
Buffalo 项目跑不起来，十次有七次卡在数据库环节——尤其用 SQLite 时。
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
buffalo new --with-sqlite3 或 buffalo g model 后执行 buffalo dev 报错，常见现象是：
cannot find package "github.com/mattn/go-sqlite3"- 或更隐蔽的
go build卡住、CPU 占满、无错误输出
根本原因是：go-sqlite3 是 cgo 包，编译时需要本地有 gcc（Linux/macOS）或 MinGW（Windows）。这不是 go get 能解决的。
解决方案分平台：
- macOS：装 Xcode Command Line Tools：
xcode-select --install - Ubuntu/Debian：
sudo apt-get install build-essential - CentOS/RHEL：
sudo yum groupinstall "Development Tools" - Windows：安装 TDM-GCC 或 MSYS2，确保
gcc在 PATH 中
如果不想碰 cgo，改用 PostgreSQL 或 MySQL —— 它们的 Go 驱动纯 Go 实现，无系统依赖，但需提前启动对应数据库服务并配好 database.yml。
packr2 不是可选插件，而是生产构建的硬依赖
很多人用 buffalo build 打包后发现 public/ 下的 CSS/JS 访问 404，或者二进制体积只有几 MB —— 这说明 packr2 没生效。
packr2 是 Buffalo 默认的静态资源打包工具，它把 public/ 目录内容编译进二进制，不是靠 go get 安装的“组件”，而是构建流程中强制介入的步骤。
关键检查点：
- 项目根目录下必须存在
public/目录（哪怕只放一个.keep文件） -
main.go头部必须有//go:generate packr2注释（Buffalo CLI 生成的项目默认就有） - 不能手动删掉
packr2自动生成的packrd.go文件
验证是否生效：
packr2 clean && packr2 && buffalo build --static
然后检查 ./bin/myapp 体积是否 ≥ 15MB；再运行它，curl localhost:3000/assets/app.css 应返回 200 和 CSS 内容。漏掉任一环，静态资源就彻底丢失。
