Webpack构建正常但watch失效,webpack serve无法检测文件变更
Webpack Watch 功能失效排查与解决
问题现象
- Webpack 执行
build构建流程全程无报错,最终输出的构建文件完全正常 - 启动开发服务时,无论命令行是否带watch参数,都无法监听到本地源文件的内容变更:实际使用的启动命令为
webpack serve --hot --watch --progress、webpack serve --hot --progress - 控制台仅输出服务初始化的启动日志,修改源文件后无任何重新编译的触发动作,该监听功能数天前可正常运行
- 提问者为 Webpack 入门用户,此前未对配置做过大改动
现有配置参考
Webpack 配置文件内容
const path = require("path"); module.exports = { mode: "production", watch: true, watchOptions: { ignored: ["**/node_modules"], }, entry: "./source/js/index.js", output: { path: path.resolve(__dirname, "assets/js"), filename: "[name].[contenthash].min.js", publicPath: "/assets/", }, devServer: { contentBase: path.join(__dirname, "assets"), compress: true, }, module: { rules: [ { test: /\.m?js$/, exclude: /(node_modules|bower_components)/, use: { loader: "babel-loader", options: { presets: ["@babel/preset-env"], }, }, }, ], }, };
失效原因与修正方案
- 生产模式配置冲突
配置里硬写了mode: "production",同时顶层开了watch: true,但 webpack serve 的文件监听逻辑本来就是给开发模式做的适配,生产模式的构建优化规则会把部分监听触发逻辑盖掉。直接在启动命令里加--mode development参数,用webpack serve --mode development --hot --progress启动,就能排除生产模式对监听流程的干扰。 - DevServer 版本兼容问题
如果用的是 Webpack Dev Server v4 及以上版本,你写的contentBase配置早就废弃了,现在统一换成static配置项。旧写法失效会直接连带搞坏devServer的文件监听模块初始化,把devServer部分的配置改成下面的样子,同时显式写清楚要监听的源文件范围,避免系统认不对监听路径:devServer: { static: path.join(__dirname, "assets"), compress: true, watchFiles: ["source/**/*"] } - 冗余参数导致的解析冲突
webpack serve本身默认就开了文件监听,你在命令行里额外加的--watch参数会被传到devServer的参数解析流程里,很容易和内置配置打架。启动的时候直接把命令行里的--watch参数删掉就行。 - 系统层面监听配额不足
之前能用、突然就不行的情况,十有八九是Linux/macOS系统的inotify文件监视配额被占满了,这种问题和项目代码没关系,临时把系统监视配额调大就能好:
排查的时候可以先把# Linux 环境临时生效 sudo sysctl fs.inotify.max_user_watches=524288watchOptions里的ignored规则全清空,测试是不是忽略规则错把源文件路径给匹配上了,导致监听范围被错误过滤。
内容的提问来源于stack exchange,提问作者kalpeshshende
相关产品推荐
相关产品推荐

