buffalo dev 启动需满足三条件:buffalo version ≥ v0.18.0、当前目录为项目根目录、显式导出 GO_ENV=development;默认仅监听 actions/、models/、templates/、locales/ 四目录,改其他文件需手动重启或加 --watch-dir;热重载为进程级重启,plush 模板不支持热加载。

直接用 buffalo dev,但必须满足三个硬条件,否则它静默失败、不报错也不启动——这是绝大多数人卡住的根本原因。
buffalo dev 启动前必须验证的三件事
它不是“敲了就跑”的命令,缺一不可:
-
buffalo version输出 ≥ v0.18.0;旧版根本不监听文件,升级用go install github.com/gobuffalo/cli/v2@latest - 当前目录是项目根目录(含
go.mod、actions/、models/和buffalo.dev.yml或main.go中调用了app.Serve()) - 终端执行前必须显式导出环境变量:
GO_ENV=development buffalo dev(.env文件无效,--env=development参数不存在)
修改代码后不重启?先看它监听哪些路径
buffalo dev 默认只监听 actions/、models/、templates/、locales/ 四个目录。改其他地方不会触发重建:
Buffalo框架 1.0.1 版本源码包下载,适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
- 改
app.go、main.go、config/env.go:不监听,必须手动重启 - 新增了
ui/components/或lib/目录:加--watch-dir ./ui/components,可重复使用多次 - 模板里用了
{{ partial "header.html" }}且header.html在partials/下:必须加--watch-dir ./partials - 用了
go:embed加载静态资源:embed 文件不在监听范围内,得手动touch actions/home.go“骗”一次重启
热重载成功 ≠ 页面自动刷新
服务重启了,但浏览器没 reload,这不是热加载失效,而是 LiveReload 没配好:
- 必须安装对应浏览器的 LiveReload 插件,否则改完模板只会重启服务,页面不动
- 如果插件已装但仍不刷新,检查中间件是否删了
Upgrade或Connectionheader(比如自定义日志中间件调用了c.Response().Header().Del("Upgrade")) - 终端最后一行输出的实际地址才是真实 URL(如
http://127.0.0.1:3002),别惯性刷:3000
真正容易被忽略的底层事实
buffalo dev 的热重载是进程级重启:每次都会 kill 旧进程、编译新二进制、拉起新服务。这意味着:
- 内存 session 一定清空,数据库连接池重置,全局变量重初始化
-
.plush模板修改后不会热加载,必须重启;只有.html模板支持热重载 - 所有中间件注册逻辑(如
app.Use())、路由注册、ORM 初始化都在重启时重新执行,无法局部更新










