macOS 上安装 Buffalo CLI 最可靠的方式是用 go install，前提是 Go 环境已就绪；需确保 go version ≥1.21（推荐1.26.0）、go env GOPATH 非空且 $GOPATH/bin 已加入 PATH，执行 go install github.com/gobuffalo/cli/cmd/buffalo@latest 后新开终端运行 buffalo version 验证。
macOS 上安装 Buffalo CLI 最可靠的方式是用 go install，前提是 Go 环境已就绪；Homebrew 安装虽快但存在隐性风险，不建议新手直接用。
确认 Go 版本和 GOPATH
Buffalo CLI 是 Go 编写的二进制工具，依赖 Go 构建链。执行以下命令验证：
-
go version必须输出go1.21或更高（推荐go1.26.0）；低于 1.21 会触发go install编译失败 -
go env GOPATH必须返回非空路径（如/Users/xxx/go）；该路径下的bin/子目录就是buffalo二进制的默认安装位置 - 若
go env GOPATH为空，运行go env -w GOPATH=$HOME/go并确保$HOME/go/bin已加入PATH
用 go install 安装 buffalo CLI
这是 macOS 上最稳定、最可控的一键安装方式，全程无需额外工具或权限：
macOS UI 自动化技能包 —— 用 Python 控制你的 Mac
下载
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
- 在终端中直接运行：
go install github.com/gobuffalo/cli/cmd/buffalo@latest - 命令会自动拉取源码、编译、安装到
$GOPATH/bin/buffalo - 安装完成后，**必须新开一个终端窗口**（或运行
source ~/.zshrc），再执行buffalo version - 若提示
command not found，说明$GOPATH/bin未在PATH中——检查echo $PATH是否包含该路径
Homebrew 安装的坑在哪
虽然 brew install buffalo 看似一键，但在 macOS 上容易引发三类问题：
- Homebrew 安装的 buffalo 二进制不走
go install流程，可能跳过 sqlite3 驱动编译步骤，导致后续buffalo new --with-sqlite3失败 - 某些 M1/M2 Mac 上，Homebrew 默认安装的是 x86_64 架构二进制，与 Apple Silicon 不匹配，运行时报
Bad CPU type in executable - Homebrew 更新 buffalo 时不会同步更新其依赖的 pop/v6 或 plush 版本，容易与新项目生成器不兼容
验证安装并生成第一个项目
成功运行 buffalo version 后，立即试一个最小闭环：
- 执行
buffalo new myapp --skip-yarn（加--skip-yarn可避免前端依赖卡住） - 进入目录：
cd myapp - 启动服务：
buffalo dev—— 默认监听http://localhost:3000 - 若页面打开但报数据库连接错误，别急着调
database.yml，先检查$DATABASE_URL是否导出（见“启动报数据库连接失败”相关逻辑）
真正容易被忽略的是：Buffalo CLI 的行为高度依赖 shell 环境变量的加载时机和作用域。哪怕 go install 成功了，如果没新开终端或没重载 shell 配置，buffalo 命令依然不可见——这不是安装失败，而是 PATH 未生效。
