buffalo框架在linux上必须用go install安装，因预编译二进制包禁用cgo、缺失sqlite编译依赖，导致buffalo new --with-sqlite3静默卡死；正确安装需go 1.21+、gcc、libsqlite3-dev及cgo_enabled=1，并通过buffalo new + buffalo db create实测验证。
Buffalo框架在Linux上安装必须用go install，其他方式（如预编译二进制）会导致SQLite驱动编译失败或buffalo new命令静默退出。
为什么不能直接下载二进制包
Linux下用curl下载官方.tar.gz包并解压到PATH，看似可行，但实际运行buffalo new --with-sqlite3时会卡在go build阶段。这是因为预编译二进制不含cgo依赖的sqlite3链接逻辑，而Buffalo的pop/soda层在生成项目时会尝试构建一个带SQLite支持的临时模型工具——它需要本地gcc和libsqlite3-dev。
- 现象：
buffalo new myapp --with-sqlite3执行后停住，无报错、无进度，Ctrl+C中断后发现myapp目录为空 - 根本原因：预编译二进制是纯静态链接，无法动态注入
cgo所需的头文件与库路径 - 验证方法：运行
buffalo version && go env CGO_ENABLED，若输出CGO_ENABLED="0"，说明当前buffalo进程禁用了cgo，必然失败
正确安装步骤（要求Go 1.21+）
确保系统已安装gcc和libsqlite3-dev（Debian/Ubuntu）或sqlite-devel（RHEL/CentOS/Fedora），然后执行：
go install github.com/gobuffalo/cli/cmd/buffalo@latest
安装完成后检查：
-
which buffalo应返回类似$HOME/go/bin/buffalo的路径 -
buffalo version输出版本号且不报错 -
go env CGO_ENABLED必须为"1"（否则重装前先执行export CGO_ENABLED=1）
常见环境陷阱
即使go install成功，以下配置错误仍会导致buffalo new失败：
-
GOPATH被手动设置：Buffalo强制使用Go modules，若env | grep GOPATH有输出，需从~/.bashrc或~/.zshrc中注释掉相关行并重启终端 - Go版本低于1.21：Buffalo 1.0.1 依赖
io/fs的某些行为，1.20及更早版本会触发undefined: fs.Glob错误 - 非root用户未配置
GOBIN：若go env GOBIN为空，go install默认写入$GOPATH/bin，而该路径可能不在PATH中；建议显式设置：go env -w GOBIN=$HOME/go/bin
验证安装是否真正可用
不要只跑buffalo version，必须实测项目生成流程：
buffalo new testapp --with-sqlite3<br>cd testapp<br>buffalo db create
若buffalo db create输出created database testapp_development，说明SQLite驱动、Pop ORM、数据库初始化三者全部连通。这一步绕不开，任何跳过它的“安装成功”都是假象。
最关键的细节往往藏在models.go里：它不读database.yml，而是靠DB_URL=sqlite3://./development.sqlite环境变量或硬编码连接字符串生效——这意味着你必须确保buffalo dev启动前，该变量已就位，否则buffalo db migrate会报no driver for sqlite3。
