Buffalo项目默认集成Webpack但必须执行npm install才能激活，否则buffalo dev因找不到node_modules/.bin/webpack而失败；其webpack.config.js仅用于开发期编译和构建期打包，输出文件由packr/v2打包进二进制。
Buffalo 项目默认已集成 Webpack，无需单独“安装”构建器——但必须执行 npm install 才能激活它，否则 buffalo dev 会直接失败。
为什么 npm install 不可跳过
Buffalo CLI 在 buffalo new 时生成的是 package.json 和 webpack.config.js，但不会自动安装 node_modules。即使你完全不用前端资源，buffalo dev 启动时仍会尝试调用 webpack --watch，找不到 node_modules/.bin/webpack 就 panic 并退出。
- 错误现象：
exec: "webpack": executable file not found in $PATH或failed to run webpack: exit status 1 - 不是权限问题，也不是 PATH 配置问题，而是根本没装依赖
- 即使删了
assets/目录，只要app.Use(plugins.Static())或app.ServeFiles还在，构建流程就仍被触发
webpack.config.js 的实际作用范围
Buffalo 的 Webpack 配置仅用于开发期资产编译（buffalo dev）和构建期打包（buffalo build），不参与 Go 二进制运行时逻辑。它输出的文件最终由 packr/v2 打包进二进制，与 Webpack 运行时无关。
HISUI 前端框架基础开发指南。HISUI 是基于 easyui 二次开发的 jQuery UI 组件库，专为医疗信息系统设计。当涉及 HISUI 组件开发、jQuery easyui 表格/表单/布局/窗口、医疗系统前端页面编写时使用此 skill。 涵盖 40 个组件的官方文档参考，支持声明式与编程式两种初始化方式，提供 $cm/$m 数据访问方法。
- 修改
webpack.config.js只影响public/assets/下产出的application.js、application.css等文件名和内容 - 若用
buffalo new --api，可安全删除整个assets/目录 +webpack.config.js+package.json，但前提是同步注释掉所有静态资源中间件 - Webpack 版本锁在
package.json中（通常是 v5.x），不建议手动升级到 v6 —— Buffalo 的packr插件未适配其模块联邦等新特性
常见构建失败原因和对应检查点
Webpack 启动失败往往不是配置问题，而是 Buffalo 的上下文干扰或路径错位。
立即学习“前端免费学习笔记（深入）”；
-
ERROR in Entry module not found: Error: Can't resolve './js/application.js'→ 检查assets/js/application.js是否被误删，该文件是 Webpack 入口，不能缺 -
FATAL ERROR: Reached heap limit Allocation failed - JavaScript heap out of memory→ 在package.json的scripts中给webpack --watch加--max-old-space-size=4096，Buffalo 不接管这个参数 - 修改
assets/css后页面无变化 → 确认浏览器没缓存旧public/assets/application.css?m=xxx，Buffalo 开发服务器不自动刷新 CSS 文件 hash，需硬刷或禁用缓存 - 想换 ESBuild？可以，但要手动移除 Webpack 相关代码，并改写
app.BuildAssets()调用逻辑——Buffalo 官方不支持开箱即用的构建器替换
真正容易被忽略的点：Webpack 构建成功不代表资源被正确加载。Buffalo 通过 packr.New 读取 public/assets/ 目录，而该目录只有在 buffalo dev 启动后由 Webpack 自动创建并填充。如果中途 kill 掉进程又没清空 public/assets/，下次启动可能复用旧文件，导致 JS/CSS 更新不生效。
