webpack 可以监听文件变化,当它们修改后会重新编译。这个页面介绍了如何启用这个功能,以及当 watch 无法正常运行的时候你可以做的一些调整。
watch
boolean
启用 Watch 模式。这意味着在初始构建之后,webpack 将继续监听任何已解析文件的更改。Watch 模式默认关闭。
watch: false
webpack-dev-server 和 webpack-dev-middleware 里 Watch 模式默认开启。
watchOptions
object
一组用来定制 Watch 模式的选项:
watchOptions: {
aggregateTimeout: 300,
poll: 1000
}
watchOptions.aggregateTimeout
number
当第一个文件更改,会在重新构建前增加延迟。这个选项允许 webpack 将这段时间内进行的任何其他更改都聚合到一次重新构建里。以毫秒为单位:
aggregateTimeout: 300 // 默认值
watchOptions.ignored
对于某些系统,监听大量文件系统会导致大量的 CPU 或内存占用。这个选项可以排除一些巨大的文件夹,例如 node_modules
:
ignored: /node_modules/
也可以使用 anymatch 模式:
ignored: "files/**/*.js"
watchOptions.poll
boolean
number
通过传递 true
开启 polling,或者指定毫秒为单位进行轮询。
poll: 1000 // 每秒检查一次变动
如果监听没生效,试试这个选项吧。Watch 在 NFS 和 VirtualBox 机器上不适用。
info-verbosity
string
: none
info
verbose
控制生命周期消息的详细程度,例如 Started watching files(开始监听文件)...
日志。将 info-verbosity
设置为 verbose
,还会额外在增量构建的开始和结束时,向控制台发送消息。info-verbosity
默认设置为 info
。
webpack --watch --info-verbosity verbose
如果您遇到任何问题,请查看以下注意事项。对于 webpack 为何会忽略文件修改,这里有多种原因。
在运行 webpack 时,通过使用 --progress 标志,来验证文件修改后,是否没有通知 webpack。如果进度显示保存,但没有输出文件,则可能是配置问题,而不是文件监视问题。
webpack --watch --progress
确认系统中有足够多的文件观察者。如果这个值太低,webpack 中的文件观察者将无法识别修改:
cat /proc/sys/fs/inotify/max_user_watches
Arch 用户,请将 fs.inotify.max_user_watches=524288
添加到 /etc/sysctl.d/99-sysctl.conf
中,然后执行 sysctl --system
。 Ubuntu 用户(可能还有其他用户)请执行:echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf && sudo sysctl -p
。
在 MacOS 中,某些情况下文件夹可能会损坏。请参阅这篇文章。
因为 webpack 期望获得多个配置选项的绝对路径(如 __dirname + "/app/folder"
),所以 Windows 的路径分隔符 \
可能会破坏某些功能。
使用正确的分隔符。即 path.resolve(__dirname, "app/folder")
或 path.join(__dirname, "app", "folder")
。
在某些机器上,Vim 预先将 backupcopy 选项 设置为 auto
。这可能会导致系统的文件监视机制出现问题。将此选项设置为 yes
可以确保创建文件的副本,并在保存时覆盖原始文件。
:set backupcopy=yes
使用 JetBrains WebStorm IDE 时,你可能会发现保存修改过的文件,并不会按照预期触发观察者。尝试在设置中禁用安全写入(safe write)
选项,该选项确定在原文件被覆盖之前,文件是否先保存到临时位置:取消选中 File > Settings... > System Settings > Use "safe write" (save changes to a temporary file first)
。