Buffalo框架已于2022年12月正式归档并停止维护，不建议用于新项目或生产环境；仅限旧项目维护、教学演示或原型验证，且须知其无安全更新、驱动兼容性下降、在Go 1.25+中存在运行时问题。
Buffalo 框架已停止维护（2022 年 12 月正式归档），不建议新项目安装或用于生产环境。如果你是维护旧项目、做教学演示或快速原型验证，可以继续使用，但必须清楚：它不再接收安全更新、驱动兼容性会逐步失效、Go 新版本（如 1.26+）可能出现未声明的运行时问题。
确认 Go 环境是否就绪
Buffalo 是 Go 编写的 CLI 工具，依赖 Go 编译器和模块系统。它不兼容 Go 1.16 之前的 go mod 行为，也不适配 Go 1.25+ 中部分 context 取消逻辑变更（已知在 buffalo dev 热重载中偶发 panic）。
- 运行
go version，确保输出为go version go1.20.15至go version go1.24.7区间（推荐1.23.8，与 Buffalo 1.0.1 最匹配） - 检查
GOBIN是否在$PATH中：echo $PATH | grep -q "$(go env GOBIN)" && echo "OK" - 禁用
GOPROXY=direct可能导致go install超时失败；建议设为https://proxy.golang.org,direct
安装 buffalo CLI 工具
Buffalo 不再发布二进制包，go install 是唯一官方支持方式。注意：自 2024 年起，github.com/gobuffalo/cli/cmd/buffalo 已重定向至归档仓库，必须指定已知可用的 commit 或 tag。
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
- 执行
go install github.com/gobuffalo/cli/cmd/buffalo@v1.0.1（这是最后一个稳定版） - 安装后运行
buffalo version，应输出v1.0.1；若报command not found，说明$(go env GOBIN)未加入$PATH - 避免使用
@latest—— 它会拉取空仓库或 404，且无任何 fallback 提示
初始化项目前必须手动装好数据库服务
buffalo new 本身不启动数据库，但默认启用 pop ORM 和迁移，若本地没跑 PostgreSQL/MySQL，buffalo dev 会立即卡在连接拒绝错误，且不会给出明确提示。
- PostgreSQL：用
brew install postgresql（macOS）或sudo apt install postgresql（Ubuntu），然后brew services start postgresql或sudo systemctl start postgresql - 验证端口：运行
nc -zv localhost 5432，成功才继续；失败则database.yml再准也白搭 - MySQL 用户注意：
host: "127.0.0.1"不能写成"localhost"，否则 Go 的 MySQL 驱动会尝试 Unix socket 连接，而多数 Docker 或 Homebrew 安装默认禁用 socket
生成项目后要立刻处理的三件事
刚执行完 buffalo new myapp，别急着 buffalo dev —— 默认配置在现代开发流中几乎必然出错。
- 删掉
assets/和templates/目录（除非你真要写带页面的 CRUD 应用）；否则buffalo dev会尝试启动 webpack，而 Node.js 版本不匹配时直接静默失败 - 编辑
app.go，注释掉app.Use(csrf.New())和app.Use(cookies.Secure())—— 这两个中间件在 API 场景下会导致 403 或空响应，且无法通过配置关闭 - 运行
go mod tidy；Buffalo 1.0.1 的go.mod锁定的是golang.org/x/net v0.14.0，若本地 Go 是 1.24+，需手动降级该依赖，否则buffalo dev启动时报undefined: http.ErrAbortHandler
最易被忽略的一点：Buffalo 的 buffalo dev 会监听整个项目目录的文件变更，包括 node_modules/ 和 vendor/。如果你保留了前端构建逻辑，文件系统 inotify 句柄可能耗尽，表现为热重载完全失灵——此时不是框架 bug，而是操作系统限制。解决方法只有两个：彻底删前端，或在 Linux 上调高 /proc/sys/fs/inotify/max_user_watches。
