乐趣区

Webpack如何配置热更新

jiezi

什么是 HMR

是指 Hot Module Replacement，缩写为 HMR。对于你需要更新的模块，进行一个 ” 热 ” 替换，所谓的热替换是指在不需要刷新页面的情况下，对某个改动进行无缝更新。如果你没有配置 HMR，那么你每次改动，都需要刷新页面，才能看到改动之后的结果，对于调试来说，非常麻烦，而且效率不高，最关键的是，你在界面上修改的数据，随着刷新页面会丢失，而如果有类似 Webpack 热更新的机制存在，那么，则是修改了代码，不会导致刷新，而是保留现有的数据状态，只将模块进行更新替换。也就是说，既保留了现有的数据状态，又能看到代码修改后的变化。

总结：

  • 加载页面时保存应用程序状态
  • 只更新改变的内容，节省调试时间
  • 修改样式更快，几乎等同于在浏览器中更改样式

依赖

package.json：

"dependencies": {
    "css-loader": "^3.2.0",
    "style-loader": "^1.2.1",
    "webpack": "^4.41.2",
    "webpack-dev-server": "^3.10.1"
},

配置

webpack:

devServer: {contentBase: path.resolve(__dirname, 'dist'),
    hot: true,
    historyApiFallback: true,
    compress: true
},
  • hot为 true，代表开启热更新
  • contentBase表示告诉服务器从哪里提供内容。（也就是服务器启动的根目录，默认为当前执行目录，一般不需要设置）
  • historyApiFallback使用 HTML5 历史记录 API 时，index.html 很可能必须提供该页面来代替任何 404 响应
  • compress对所有服务启用 gzip 压缩
plugins: {HotModuleReplacementPlugin: new webpack.HotModuleReplacementPlugin()
},

配置热更新插件

module: {
    rules: [
        {test: /\.(css|less)$/,
            use: [process.env.NODE_ENV == 'development' ? { loader: 'style-loader'} : MiniCssExtractPlugin.loader,
                {
                    loader: 'css-loader',
                    options: {importLoaders: 1}
                }
            ]
        }
    ]
},

style-loader库实现了 HMR 接口，当通过 HMR 收到更新时，它将用新样式替换旧样式。区分开发环境和生产环境，用不同 loader。

src/index.jsx：

if (module.hot) {module.hot.accept();
}

入口文件，新增上面代码，就可以了，非常简单。

如何保存状态

使用 react-hot-loader 插件，传送门

如何使用

安装

$ npm install react-hot-loader

配置babelrc

// .babelrc
{"plugins": ["react-hot-loader/babel"]
}

将根组件标记为热导出

import {hot} from 'react-hot-loader/root';
const App = () => <div>Hello World!</div>;
export default hot(App);

在 react 和react dom之前，确保需要 react 热加载程序

// webpack.config.js
module.exports = {entry: ['react-hot-loader/patch', './src'],
  // ...
};

遇到问题

如果遇到You cannot change <Router history>，那么应该这样配置：

import {hot} from 'react-hot-loader/root';
const Routes = () => {};
export default hot(Routes);

案例

Tristana

遇到问题

配置完热更新之后，遇到 webpack 自动编译两次问题，很大概率出现，具体原因，没有分析，找到一个讨巧的解决办法，配置：

watchOptions: {aggregateTimeout: 600},

也有可能是其他问题，比如你在 index.html 页面，重复引入了 index.js，又或者是全局安装了webpack-dev-server，与本地webpack-dev-server 重复，卸载全局webpack-dev-server，即可。

退出移动版