必须先安装buffalo cli并确保$gopath/bin已加入path，否则buffalo new、dev等命令均报command not found；需用go 1.23或1.24版本，执行go version验证；安装后新开终端运行buffalo version确认成功。
必须先装好 Buffalo CLI，否则所有后续命令（如 buffalo new、buffalo dev）都会报 command not found。
确认 Go 环境是否达标
Buffalo 是用 Go 写的 CLI 工具，对 Go 版本有硬性要求：
- 运行
go version，输出必须是go1.21或更高——低于此版本会触发go install编译失败 - 运行
go env GOPATH，确保返回一个非空路径（比如/home/you/go），这是go install默认放二进制的位置 - 若未安装 Go，去 https://www.php.cn/link/81836b7cd16991abb7febfd7832927fd 下载
go1.26.0（当前稳定兼容版），并配置好PATH
安装 buffalo CLI 的两种可靠方式
推荐优先用 go install，它最轻量、版本可控；预编译包适合没装 Go 的环境。
Buffalo框架 1.0.1
下载
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
- 执行：
go install github.com/gobuffalo/cli/cmd/buffalo@latest—— 会自动拉源码、编译、放到$GOPATH/bin/buffalo - 若提示
cannot find module providing package，大概率是 Go 版本太低或 GitHub 访问失败，此时改用预编译包 - Linux/macOS：去 GitHub Releases 下载
buffalo_*.tar.gz，解压后把buffalo二进制复制到/usr/local/bin/并chmod +x - Windows：用 Scoop 更省心：
scoop bucket add extras→scoop install buffalo（自动注册 PATH）
⚠️ 安装完务必新开终端，再运行 buffalo version 验证——如果还报 command not found，90% 是 $GOPATH/bin 没进系统 PATH。
初始化第一个项目并跑起来
CLI 装好后，才是真正的“从零开始”：
- 新建空目录，进入后执行：
buffalo new myapp—— 会生成完整项目结构、go.mod、数据库配置等 - 若想建纯 API 服务（跳过前端 assets 和 templates），加
--api：buffalo new myapp --api - 进项目目录，先装依赖：
go mod tidy（Go 侧） +npm install（前端侧，非--api项目才需要） - 初始化数据库：
buffalo db create→buffalo db migrate（这步漏掉，buffalo dev启动后访问页面会 panic） - 最后启动：
buffalo dev—— 默认监听:3000，热重载生效；端口被占可加-p 4000
真正卡住新手的，往往不是语法或逻辑，而是 buffalo 命令根本不存在，或者 buffalo dev 起来了但一刷新就 panic——这两个问题，80% 出在 CLI 没装对、或数据库迁移忘执行。
