webpackdevserver配置项（配置Webpack Dev Server 实战操作方法步骤）

本文摘要：配置 Webpack Dev Server 可以解决本地开发前端应用时    
    
    
，手动执行 webpack 命令或 yarn build 命令 


     


     


     ，再去浏览器中访问 dist/index.html 的麻烦耗时操作

 




 




 



，可有效简化流程    
    
    
。本文实战演练配置 Webpack Dev Server 的方法与步骤 


     


     


     。

在本地开发前端应用时   

   

   

，每次都手动执行 webpack 命令或 yarn build 命令  

     

     

    ，再去浏览器中访问 dist/index.html 是一件非常麻烦耗时的事情


  




  




  


，可以通过配置 Webpack Dev Server 来解决这个问题

 




 




 



。实际上 vue-cli 中也配置了 Webpack Dev Server  


  


  


，每次启动 Vue 应用的命令 yarn serve   
     
     
   ，本质上就是启动 Webpack Dev Server   

   

   

。

webpack-dev-server 官网地址：https://webpack.js.org/configuration/dev-server/

1 安装依赖

由于我们使用的 webpack 版本是当前最新的5.73.0
    
    
    
、 webpack-cli 版本是4.9.2



   




   




   

， webpack-dev-server 的版本也要使用最新的 4.x:

yarn add webpack-dev-server -D

当前版本为 4.9.3  

     

     

    。

2 添加运行命令

在 package.json 文件的 scripts 节点中添加启动 webpack dev server 的命令：

"scripts": { "build": "webpack", "serve": "webpack-dev-server" },

3 修改 webpack 配置

在 webpack.config.js 中 entry     


     


     


、 plugins 




 




 




 、mode 同级新增节点 devServer 



 



 



，基本的配置如下：

// ... module.exports = { // ... devServer: { port: 9000, host: 0.0.0.0, hot: true }, // ... }

该配置表示通过url：http://localhost:9000 来访问应用


  




  




  


。除了配置端口

   

   

   
、允许访问的 host 外                ，还可以配置 proxy 实现跨域等  


  


  


。更多配置在上面的官网中查看   
     
     
   。

4 启动服务

前面已经在 package.json 中配置了 serve 命令




    




    




    
，执行 yarn serve 命令启动 webpack dev server



   




   




   

。启动成功后在浏览器中访问 http://localhost:9000 即可访问应用 



 



 



。

注意：

修改了 webpack 的配置（ webpack.config.js）需要重启 webpack dev server 才会生效                。 devServer 的配置只对本地开发调试有效














，不影响编译打包构建（yarn build）的效果




    




    




    
。

5 高效开发的配置

5.1 devtool

默认情况下                ，如果在 js 代码中通过 console.log 打印日志



     



     



     ，或程序报错时















，浏览器 console 中输出的内容是经过 webpack 打包编译后的代码位置    
    
    
，如下图所示：

点击上图中的 main.js:21 


     


     


     ，显示的代码如下：

当代码较多时较难定位问题














。可把 devtool 的配置为 source-map ：

// ... module.exports = { // ... devServer: { // ... }, devtool: source-map, // ... }

配置后

 




 




 



，重启 webpack-dev-server   

   

   

，点击浏览器控制台中输出的 console.log   

     

     

    ，会进入源码对应的位置：

source-map 源码映射


  




  




  


，webpack 会自动生成源代码与打包构建后的代码的映射关系的文件（xxx.map）  


  


  


，通过该映射文件   
     
     
   ，找到打包构建后的代码对应的源码



   




   




   

，从而使浏览器提示源码文件的位置                。

5.2 HMR

HMR：Hot Module Replacement 热模块替换



     



     



     。当修改代码时 



 



 



， webpack 默认会将所有模块全部重新打包编译                ，整个页面重新加载




    




    




    
，速度很慢















。HMR 热模块替换支持在程序运行中（webpack-dev-server 已启动）














，修改哪个模块                ，就自动修改（替换     

     

     

、添加  




  




  




 、删除）该模块



     



     



     ，需用全部打包所有模块    
    
    
。

上面 devServer 的配置的 hot: true 已经开启了HMR 


     


     


     。开启 HMR 后















，修改样式整个页面不会刷新    
    
    
，但 JS 不生效

 




 




 



。不过在现代化开发中 


     


     


     ，vue-loader 等实现了 HMR

 




 




 



，例如你修改了 vue 的某个组件   

   

   

，保存后只会替换该组件   

   

   

。

今日优雅哥（youyacoder）学习结束  

     

     

    ，期待关注留言分享~~