Buffalo项目初始化慢的本质是网络依赖多、默认行为重，需三步优化：设GOPROXY代理、用--api/--skip-yarn跳过前端、避免SQLite编译；go install卡住主因是GitHub直连超时，应优先配置代理或改用预编译包。
Buffalo 项目初始化慢，本质是网络依赖多、默认行为重——跳过非必要环节、换代理、禁用前端，三步就能把 buffalo new 从 3 分钟压到 30 秒内。
go install buffalo CLI 时卡住或报错
根本原因不是 Buffalo 本身，而是 go install 在拉取 GitHub 仓库时被阻断。Go 1.21+ 默认不走 GOPROXY，国内直连 github.com 极易超时或返回 “cannot find module”。
- 执行前先设代理：
export GOPROXY=https://goproxy.cn,direct（macOS/Linux）或set GOPROXY=https://goproxy.cn,direct（Windows CMD） - 再运行：
go install github.com/gobuffalo/cli/cmd/buffalo@latest - 若仍失败，说明本地 Go 环境缺失
gcc（尤其 macOS M 系列或 Windows WSL），此时必须用预编译包：去https://github.com/gobuffalo/cli/releases下载对应系统的buffalo_*.tar.gz，解压后chmod +x buffalo && sudo mv buffalo /usr/local/bin/
buffalo new 初始化太慢
默认会同时拉 Go 模块、npm install 前端依赖、生成模板、初始化 SQLite 驱动（需编译 C），任一环节卡住都会拖慢整个流程。
Buffalo框架 1.0.1
下载
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
- 纯 API 项目直接加
--api：buffalo new myapp --api，跳过assets/和templates/目录，省掉 npm/yarn 步骤 - 不想碰前端但保留 Web 能力？加
--skip-yarn：buffalo new myapp --skip-yarn，CLI 不再尝试执行yarn install，后续需要时再手动装 - 用 PostgreSQL/MySQL 就别碰 SQLite：
buffalo new myapp --db postgres或--db mysql，避免因缺失gcc导致go build卡死在 sqlite3 编译阶段
第一次运行 buffalo dev 前的依赖安装顺序错不得
buffalo dev 启动时会尝试编译前端、加载模型、连接数据库——任意一环缺依赖就 panic 退出，不是“慢”，是直接失败。
- 先跑
go mod tidy：补全所有 Go 子依赖，buffalo db migrate依赖github.com/gobuffalo/pop/v6，漏了就报panic: no driver for dialect "postgres" - 再跑
npm install（或yarn install）：即使你删了assets/，buffalo dev默认仍会调用 webpack，找不到node_modules就中断 - 最后才是
buffalo db create && buffalo db migrate：注意database.yml中的dialect必须小写且拼写准确（postgres，不是postgresql），否则buffalo db create会静默失败
buffalo dev 启动后热重载卡顿或内存暴涨
这不是代码问题，是开发模式默认启动了三套监控服务：Webpack 监听、packr 资源打包、refresh 进程重启器——每项都吃内存、占 CPU。
- 临时提速：改用
air替代buffalo dev，在项目根目录放.air.toml，只监听actions/和models/，跳过前端构建：build.cmd = "go build -o ./tmp/main ." - 长期方案：确认
GO_ENV=development，然后在app.go中注释掉app.Use(middleware.Compress())和app.Use(middleware.CORS())，这两项在开发期毫无意义却显著拖慢 reload 周期 - 警惕
buffalo dev -p 4000后没关老进程：多个buffalo dev实例共存会导致文件监听冲突，表现为修改代码后无反应，需pkill -f "buffalo dev"清理
最常被忽略的是：buffalo 的“快”建立在约定路径和默认配置上，一旦你删了 assets/ 却没关掉 Webpack 监听，或者换了数据库却忘了改 database.yml 的 dialect，它不会报错提示“你配错了”，而是沉默地卡住、panic、或返回空响应——优化不是加功能，是精准剪枝。
