注意: 这是 Parcel 1 版本的中文文档。如需 Parcel 2 中文文档请进此链接: v2.parceljs.cn

🔥 热模块重载(HMR)

热模块重载 (HMR) 在运行时自动更新浏览器中的模块优化开发体验,无需刷新整个页面。这意味着在您代码小幅更改时可以保留应用程序的状态。Parcel 的 HMR 实现支持开箱即用的 JavaScript 和 CSS 资源。HMR 构建在生产模式下时自动禁用。

保存文件时,Parcel 将重新编译所更改的内容,并将包含新代码的更新发送到任何正在运行的客户端。新的代码会替换旧版本的代码并执行,其所有父模块代码也会重新执行。你可以使用 module.hot API 对此过程进行 hook ,编写这段代码会在你处理模块时或有新版本进入时通知您。类似项目 react-hot-loader 可以帮助你完成该过程,并通过 Parcel 实现开箱即用。

有两种已知方法: module.hot.acceptmodule.hot.dispose 。你可以调用 module.hot.accept 并赋予一个回调函数,该函数会在模块或其他依赖项被更新时执行。当该模块即将被替换时,module.hot.dispose 回调函数会被调用。

if (module.hot) {
  module.hot.dispose(function() {
    // 模块即将被替换时
  })

  module.hot.accept(function() {
    // 模块或其依赖项之一刚刚更新时
  })
}

自动安装依赖项

每当 Parcel 遇到符合 node_module 模式且无法找到它的依赖项时,Parcel 会尝试使用 yarn 或 npm 安装此依赖项这取决于是否找到 yarn.lock 文件。这可以避免开发人员不得不退出 parcel 或打开多个终端窗口来安装依赖。

这只会在 development 模式下触发(使用 servewatch),然而在生产模式是禁止的(使用build)这样避免在部署的时候产生意想不到的副作用。

你可以禁止使用这个特性 --no-autoinstall

安全写入(Safe Write)

一些文本编辑器和 IDE 均有安全写入的功能,这基本上可以防止数据丢失,通过获取文本的副本并在保存时对其进行重命名操作。

当使用热模块重载 (HMR) 时,此功能会阻止文件更新的自动检测,要禁用安全写入,请使用下列提供的选项:

帮助我们改善文档

如果有遗漏或者不清楚的地方,请在本站的仓库 提交issue 或者 编辑此页面.