buffalo dev 仅在存在 assets/ 目录、package.json 及有效 "build" 脚本时自动构建前端资源,否则静默跳过;需手动安装依赖、配置构建脚本,并注意与 buffalo build 的打包差异。

buffalo dev 会自动构建前端资源,但只在特定条件下生效
执行 buffalo dev 时,它**不会无条件触发构建**,而是依赖项目是否含 assets/ 目录、package.json 和有效的 build 脚本。如果你用 buffalo new myapp --with-nodejs 初始化,这些都就位;但若手动删过 assets/ 或改过 package.json,构建就会静默跳过。
常见错误现象:
- 修改
assets/js/application.js后页面没更新 →buffalo dev没监听到变更,可能因watch配置缺失或node_modules不完整 - 浏览器加载 JS/CSS 404 →
buffalo dev启动成功但未运行构建,public/assets/下空空如也
实操建议:
- 确认
assets/package.json中存在"build"脚本(如"build": "webpack --mode=production") - 首次启动前必须进
assets/目录执行yarn install或npm install,否则buffalo dev会直接退出 - 不推荐用
go run main.go替代 —— 它完全绕过构建逻辑,连public/目录都不读
生产环境必须显式运行 buffalo build,dev 不打包
buffalo dev 只做开发态构建:把编译结果写入 public/assets/ 并由内置 HTTP server 提供服务;而 buffalo build 才会把静态资源嵌入二进制,这是生产部署的唯一合法路径。
立即学习“go语言免费学习笔记(深入)”;
关键差异:
-
buffalo dev:实时监听assets/变更,调用yarn build(或npm run build),输出到public/ -
buffalo build:先执行同上的构建步骤,再用packr将public/打包进二进制,最终生成单文件可执行程序
容易踩的坑:
阿拉丁·前端工程工坊把「前端只会写页面、规范停在文档里、脚手架手敲、构建靠抄、性能靠猜、可访问性靠忘」从「手动搭项目、抄配置、肉眼查规范」升级成一条本地工具链——多框架脚手架生成(React/Vue3/Svelte + Vite)、可复用组件生成(Props 类型+样式+示例)、规范落地检查(lint-lite:命名/未用变量/console残留/TS any/目录结构)、构建配置生成与产物体积预算、性能审计(依赖体积/重复/懒加载/Lighthouse 清单)、可访问性(a11y)校验(alt/aria
- 误以为
buffalo dev构建的产物能直接扔进容器 → 实际上它依赖本地public/目录,没打包,容器里必然 404 - 跨平台构建漏加参数 → 必须指定
GOOS=linux GOARCH=amd64 buffalo build --static,否则 macOS 构建的二进制在 Linux 容器跑不起来 - 删了
assets/却没删app.Use(plugins.Static())→buffalo build仍尝试打包不存在的目录,卡住或报错
禁用前端构建的两种安全方式
纯 API 项目不需要任何前端资源,但 Buffalo 默认仍会尝试构建——哪怕你删光 assets/,buffalo dev 也会因找不到 node_modules 而失败。必须从初始化阶段就切断依赖。
正确做法分两类:
- 新建项目时加
--skip-yarn:buffalo new myapi --api --skip-yarn,它跳过assets/目录和package.json生成 - 已有项目想移除:删掉
assets/、node_modules/、public/,然后注释掉app.Use(plugins.Static())和所有app.ServeFiles调用
注意:
- 别只删
assets/就完事 ——buffalo dev启动时仍会检查package.json是否存在,找不到就 panic - 如果用了
--with-nodejs初始化又后悔了,手动删assets/后,务必进项目根目录运行go mod tidy清理掉github.com/gobuffalo/packr/v2等无关依赖
Webpack/Vite 等现代构建工具需手动集成
Buffalo 默认用 Webpack(老版本)或自定义构建脚本,不原生支持 Vite、esbuild 或 Turbopack。想换构建链,不能靠参数开关,得手动替换。
操作要点:
- 保留
assets/目录结构,但重写package.json中的build和watch脚本(如"build": "vite build") - 确保 Vite 输出路径为
assets/dist/(或对应public/assets/的子路径),否则buffalo dev找不到产物 - 修改
app.go中的静态文件路由,指向新路径:app.ServeFiles("/assets/", http.Dir("public/assets"))
风险提示:
- Vite 的
dev server和buffalo dev不能共存 —— 二者都会占 3000 端口,且热重载逻辑冲突 - 不要在
vite.config.ts里配base: "/assets/"以外的路径,否则产出的index.html会引用错位的 JS/CSS - 国内网络下
vite build拉依赖慢,建议提前设好yarn config set registry https://registry.npm.taobao.org
buffalo build 的打包行为由 packr 控制,而它只认 public/ 目录下的文件 —— 如果你让 Vite 输出到 dist/,却没软链或复制到 public/assets/,最终二进制里就没有前端资源。

















