Buffalo dev启动慢主要因Go模块下载、插件检查和前端依赖安装三类耗时操作；可通过观察终端输出定位卡点，用go run main.go绕过、禁用插件检查或--skip-yarn创建API项目优化。
buffalo dev 启动卡住或超慢，怎么定位瓶颈
多数人遇到的“慢”其实不是 Buffalo 本身慢，而是它在启动时默认触发三类耗时操作：Go 模块下载、插件自动检查、前端依赖安装。不干预的话，buffalo dev 可能卡在 go mod download、buffalo plugins install 或 yarn install 阶段，本地等待常超 2 分钟。
快速判断卡在哪一步：观察终端最后一行输出。若停在 Installing dependencies... 且无后续，大概率是 Node.js 部分；若卡在 Downloading modules...，则是 Go proxy 不可用；若反复出现 Checking for plugin updates...，说明插件检查在重试。
- 临时绕过所有网络依赖：用
go run main.go启动，跳过buffalo dev的封装层 - 确认 Go 代理是否生效：
go env GOPROXY必须输出https://goproxy.cn,direct，不是https://proxy.golang.org,direct - 禁用插件检查：在
app.go中app.Init()调用前加os.Setenv("BUFFALO_PLUGIN_CHECK", "false")
创建 API 项目时如何跳过无用构建环节
执行 buffalo new myapi --api 默认仍会生成 assets/、拉取 Webpack 插件、预编译模板——这些对纯 JSON API 完全冗余，且拖慢初始化和后续每次 buffalo dev 启动。
真正该做的不是“删掉生成的文件”，而是在创建时就切断源头：
- 加
--skip-yarn：buffalo new myapi --api --skip-yarn，直接跳过yarn install和webpack相关逻辑 - 删掉
templates/目录后，顺手注释掉app.PrecompileTemplates()，避免启动时报错 - 移除所有
r.HTML(...)调用，只保留c.Render(200, r.JSON(...))，Buffalo 就不会加载 HTML 渲染器和模板解析器 - 删掉
assets/后，确保app.Use(middleware.Static("public"))这类静态中间件也被注释或删除
热重载太卡或失效，换什么替代方案更稳
buffalo dev 的 watcher 基于文件系统事件，容易受 IDE 临时文件、Git 操作、macOS 的 FSEvents 延迟影响，尤其在大项目中频繁假死或漏触发。它还强制依赖 buffalo-plugins，一旦插件二进制损坏，整个热重载就瘫痪。
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
更轻量可控的方式是用通用 Go 热重载工具接管：
- 用
air：它不依赖 Buffalo 插件体系，只监听.go文件变更，启动快、重启准。配置.air.toml指向main.go即可 - 禁用
buffalo dev的内置重载：启动时加--no-watch参数，再配合air或fresh - CI/CD 构建阶段必须禁用热重载：
buffalo build --static生成的是静态二进制，不带 watcher，体积小、启动快
go build 编译产物臃肿，怎么精简生产二进制
Buffalo CLI 不透传任何 go build 优化参数，buffalo build 默认生成的二进制含调试符号、未 strip、启用 CGO，体积常达 20MB+，且启动慢。
必须绕过 CLI，直接调用 go build 并显式控制参数：
- 禁用 CGO：
CGO_ENABLED=0 go build，避免动态链接 libc，提升跨平台兼容性 - 裁剪符号和调试信息：
-ldflags="-s -w"，注意必须写成一个参数，不能拆开 - 启用模块只读模式：
-mod=readonly，防止意外升级依赖 - 推荐命令：
CGO_ENABLED=0 go build -trimpath -ldflags="-s -w" -mod=readonly -o ./bin/app ./cmd/app
Windows 下 -w 无效，但 -s 仍可减小体积；若项目依赖 SQLite 或 OpenSSL，则 CGO_ENABLED=0 会导致构建失败，此时只能保留 CGO 并接受稍大体积。
