Buffalo本身不依赖cgo，但其默认生成器引入的pop及MySQL驱动（如github.com/go-sql-driver/mysql）必须启用cgo才能编译；PostgreSQL驱动lib/pq则纯Go、无需cgo。常见报错源于残留MySQL导入、go.mod中存在cgo依赖或app.go中未清除pop相关中间件调用。
buffalo 本身不依赖 cgo，但它的默认生成器会拉入 pop（数据库迁移层）和 github.com/lib/pq 或 github.com/go-sql-driver/mysql 等驱动——这些驱动在启用 cgo 时才可编译。如果你的环境禁用了 cgo（比如 CGO_ENABLED=0），或系统缺失 C 工具链（gcc、pkg-config），go build 或 buffalo dev 就会报类似 exec: "gcc": executable file not found in $PATH 或 #include 的错误。
为什么 buffalo new --api 会触发 cgo 报错
执行 buffalo new myapp --api 默认启用 PostgreSQL 支持，并自动写入 database.yml 和 pop/pop.go，进而间接引入 lib/pq。而 lib/pq 是纯 Go 驱动，**不依赖 cgo**；但很多用户会手动改用 mysql 驱动，或未注意 Buffalo 模板中残留的 _ "github.com/go-sql-driver/mysql" 导入 —— 这个驱动**必须启用 cgo** 才能编译。
常见诱因包括：
- 你删了
database.yml却没删models/models.go里的 MySQL 驱动导入 -
go.mod中残留github.com/go-sql-driver/mysql v1.7.1，且项目里有任意import _ "github.com/go-sql-driver/mysql" - 你运行了
buffalo db create或buffalo db migrate，触发 pop 加载驱动逻辑，即使没实际连库
禁用 cgo 场景下怎么让 buffalo 正常构建
核心原则：**移除所有强制依赖 cgo 的路径，把数据库支持降级为“声明式存在，运行时可选”**。
操作清单：
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
- 删掉
models/目录（如果你真不需要 ORM/迁移）；或保留但注释掉所有_ "github.com/go-sql-driver/mysql"或_ "gopkg.in/goracle.v2"类导入 - 检查
app.go，确认没有调用pop.Connect()、pop.NewMigrationBox()等函数 - 在
main.go开头加// #nosec注释（非必需），并在构建时显式关闭 cgo：CGO_ENABLED=0 go build -o myapi . - 如果仍需轻量数据库访问（如只读查询），改用
github.com/jackc/pgx/v5（纯 Go，CGO_ENABLED=0友好）并手动初始化pgxpool.Pool，绕过 pop
buffalo dev 启动时报 cgo 错误怎么办
buffalo dev 会自动加载整个应用上下文，包括 models 初始化逻辑 —— 即使你没定义任何 model struct，只要 models/models.go 存在且含驱动导入，它就会失败。
快速验证方式：
- 临时重命名
models/为models.off/，再跑buffalo dev；如果成功，说明问题就在这里 - 不要依赖
buffalo db generate等命令，它们隐式绑定 pop 和 cgo 驱动链 - 若你坚持用
buffalo dev（而非go run main.go），请确保GOOS/GOARCH与本地工具链匹配，且已安装gcc（macOS 装 Xcode Command Line Tools，Linux 装build-essential或gcc-c++）
真正容易被忽略的一点：Buffalo 的 pop 不是“可插拔”的——它深度耦合在 app.New() 生命周期里。哪怕你删光了 models/，只要 app.go 里还留着 app.Use(popmw.Transaction(models.DB)) 这类中间件，启动时仍会 panic。清理必须彻底，不能只删文件，还要扫代码里的调用痕迹。
