Buffalo 框架通过 buffalo dev 命令实现热加载，自动监听代码、模板、静态资源变更并重启服务；需确保 CLI 版本 ≥v0.18.0、存在 buffalo.dev.yml 或 app.Serve() 调用，支持命令行参数与 YAML 配置自定义监听行为，并提供端口冲突、监听失效、缓存卡死等排查步骤。
在 Buffalo 框架中启用 dev 命令热加载，能让你修改 Go 代码、模板或静态资源后自动重建并重启服务，无需手动 stop → build → run。
确认项目已初始化为 Buffalo 应用
执行 buffalo version 查看输出是否包含 Buffalo CLI 版本号且不低于 v0.18.0；若命令未识别，需先通过 go install github.com/gobuffalo/cli/v2@latest 安装 CLI 工具。
确保当前目录下存在 buffalo.dev.yml 或 main.go 中调用了 app.Serve()，否则 buffalo dev 启动会失败。
启动热加载开发服务器
在项目根目录下直接运行：
buffalo dev
该命令会自动监听 actions/、models/、templates/、assets/ 等目录变化，并触发增量编译与服务重启。默认绑定 http://127.0.0.1:3000。
如果端口被占用，CLI 会自动尝试下一个可用端口并打印提示——但不会静默跳过，【必须留意终端输出的实际地址】，否则可能误以为服务没起来。
自定义热加载行为
方法一：通过命令行参数临时覆盖
buffalo dev --port 4000 --log-level debug --watch-dir ./custom
其中 --watch-dir 可追加额外监控路径，比如你把组件抽离到 ./ui/components，不加此参数就不会响应改动。
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
方法二：使用配置文件精细控制
在项目根目录创建 buffalo.dev.yml，写入：
watchers: golang: ignore: - "vendor" - "node_modules" extensions: ["go", "mod"] templates: extensions: ["html", "plush"]
这个配置比命令行更稳定，尤其适合团队统一规范。注意 YAML 缩进必须为两个空格，多一个少一个都会导致解析失败而退回到默认行为。
常见问题排查步骤
第一步：检查进程是否真在运行
执行 ps aux | grep buffalo，确认有 buffalo dev 进程且不是僵尸态；若只看到 buffalo dev 但浏览器打不开，大概率是端口冲突或防火墙拦截。
第二步：验证文件变更是否被检测
修改任意一个 actions/home.go 文件末尾加一行 // test 并保存，观察终端是否立即输出 [0001] Building… 和后续 Starting application at http://…。没有输出说明监听失效，此时应检查 buffalo.dev.yml 中的 watchers 配置路径是否拼错。
第三步：强制清除缓存重试
执行 buffalo dev --clean，这会删除 tmp/ 目录并重建构建环境，解决因 stale object 导致的热加载卡死问题。
