美文网首页js
【Webpack】简单运用

【Webpack】简单运用

作者: 嘻洋洋 | 来源:发表于2019-08-20 19:36 被阅读0次

    1. 安装步骤

    (1)安装全局webpack【node.js安装】
    npm install -g webpack
    npm install -g webpack-cli(webpack 4X 后需要安装webpack-cli )
    (2)npm init 初始化项目
    目的: 在项目中引导创建一个package.json文件。package.json是基于nodejs项目必不可少的配置文件,它是存放在项目根目录的普通json文件。
    步骤:npm init命令后,npm会询问你一系列问题,当你填入答案后才会正式结束初始化,如果不太想自定义一些关于项目的描述,可以不敲npm init,而是直接敲npm init --yes
    Package.json 属性说明
    name - 包名。
    version - 包的版本号。
    description - 包的描述。
    homepage - 包的官网 url 。
    author - 包的作者姓名。
    contributors - 包的其他贡献者姓名。
    dependencies - 依赖包列表。如果依赖包没有安装,npm 会自动将依赖包安装在 node_module 目录下。
    repository - 包代码存放的地方的类型,可以是 git 或 svn,git 可在 Github 上。
    main - main 字段指定了程序的主入口文件,require('moduleName') 就会加载这个文件。这个字段的默认值是模块根目录下面的 index.js。
    keywords - 关键字
    (2)npm install 下载依赖
    详细查看我的另外一篇文章,在这里要在项目中安装webpack:npm install --save-dev webpack

    2.在终端进行打包

    webpack {entry file} {destination for bundled file}
    (1)webpack4.0以上命令行模式下【不用配置文件】
    命令:webpack js/index.js -o html/bundle.js --mode development 【注:-o 代表打包输出文件,-mode 选择版本模式】


    image.png

    webpack同时编译了main.js 和Greeter,js,合并生成了一个文件bundle.js。
    (2)webpack4.0以下版本模式
    webpack js/index.js html/bundle.js (非webpack4.0)

    我们可以在package.json配置执行命令:

      "scripts": {
        "test": "echo \"Error: no test specified\" && exit 1",
        "build":"webpack js/index.js -o html/bundle.js --mode development"
      }
    //bat文件运行:npm run {script name}
    npm run build
    

    终端中进行复杂的操作,其实是不太方便且容易出错的,通常都是通过配置文件处理。
    (3)webpack 命令参数说明

    "scripts": {
        "build": "webpack  --profile --progress --colors --display-error-details",
        "dev": "webpack  --display-modules --profile --progress --colors --display-error-details"
    }
    

    color 输出结果带彩色,比如:会用红色显示耗时较长的步骤
    profile 输出性能数据,可以看到每一步的耗时
    progress 输出当前编译的进度,以百分比的形式呈现
    display-modules 默认情况下 node_modules 下的模块会被隐藏,加上这个参数可以显示这些被隐藏的模块
    display-error-details 输出详细的错误信息

    3.通过配置文件来使用Webpack

    (1)项目根目录下新建webpack.config.js文件

    //“__dirname”是node.js中的一个全局变量,它指向当前执行脚本所在的目录
    module.exports = {
      entry:  __dirname + "/js/index.js",//已多次提及的唯一入口文件
      output: {
        path: __dirname + "/html",//打包后的文件存放的地方
        filename: "bundle.js"//打包后输出文件的文件名
      }
    }
    

    (2) 执行webpack命令,命令会自动引用webpack.config.js文件中的配置选项。


    image.png

    或者通过bat文件

      "scripts": {
        "test": "echo \"Error: no test specified\" && exit 1",
        "build":"webpack js/index.js -o html/bundle.js --mode development"
        "start":"webpack"
      }
    

    4.Source Maps

    通过打包后的文件,是不容易找到出错了的地方,对应的你写的代码的位置的,Source Maps就是来帮我们解决这个问题的。在webpack的配置文件中配置source maps,需要配置devtool。配置项很多,详细说明:

    eval: 使用eval包裹模块代码,eval关键字的配置项并不单独产生.map文件。
    source-map: 产生.map文件
    cheap: 不包含列信息(关于列信息的解释下面会有详细介绍)也不包含loader的sourcemap
    module: 包含loader的sourcemap(比如jsx to js ,babel的sourcemap)
    inline: 将.map作为DataURI嵌入,不单独生成.map文件(这个配置项比较少见)
    

    举例:eval-source-map是eval和source-map的组合,可知使用eavl语句包括模块,也产生了.map文件。webpack将.map文件作为DataURI替换eval模式中末尾的//# souceURL。
    配置项目分析和区别:

    • webpack在构建时的性能上, 总的来说eval性能最好,source-map性能最低。
    • 使用 cheap 模式可以大幅提高 souremap 生成的效率。大部分情况我们调试并不关心列信息,而且就算 sourcemap 没有列,有些浏览器引擎(例如 v8) 也会给出列信息
    • 使用 module 可支持 babel 这种预编译工具(在 webpack 里做为 loader 使用)。
    • val-source-map 模式可以减少网络请求。这种模式开启 DataUrl 本身包含完整 sourcemap 信息,并不需要像 sourceURL 那样,浏览器需要发送一个完整请求去获取 sourcemap 文件,这会略微提高点效率。而生产环境中则不宜用 eval,这样会让文件变得极大。

    总结出最佳模式:
    (1)开发环境推荐:cheap-module-eval-source-map
    (2)生产环境推荐:cheap-module-source-map (这也是下版本 webpack 使用-d命令启动 debug 模式时的默认选项)
    注:vue-cli脚手架搭建的工程,开发环境使用的是eval-source-map,生产环境用的是source-map。正式环境如果直接将sourceMap放入打包后的文件,会明显增大文件的大小,不利于静态文件的快速加载;而外联.map时,.map文件只会在F12开启时进行下载(sourceMap主要服务于调试),故推荐使用外联.map的形式。

    4.webpack构建本地服务器

    让浏览器监听代码的修改,并自动刷新显示修改后的结果,Webpack提供一个可选的本地开发服务器插件: webpack-dev-server,先要安装此插件

    npm install --save-dev webpack-dev-server
    

    devserver作为webpack配置选项中的一项,参数说明:

    • contentBase
      默认webpack-dev-server会为根文件夹提供本地服务器,如果想为另外一个目录下的文件提供本地服务器,应该在这里设置其所在目录(本例设置到“public"目录)
    • port
      设置默认监听端口,如果省略,默认为”8080“
    • inline
      设置为true,当源文件改变时会自动刷新页面
    • historyApiFallback
      在开发单页应用时非常有用,它依赖于HTML5 history API,如果设置为true,所有的跳转将指向index.html

    具体配置

    //webpack.config.js
    //“__dirname”是node.js中的一个全局变量,它指向当前执行脚本所在的目录
    module.exports = {
      devtool: 'cheap-module-eval-source-map',
      entry:  __dirname + "/js/index.js",//已多次提及的唯一入口文件
      output: {
        path: __dirname + "/html",//打包后的文件存放的地方
        filename: "bundle.js"//打包后输出文件的文件名
      },
       devServer: {
        contentBase: "./html",//本地服务器所加载的页面所在的目录
        historyApiFallback: true,//不跳转
        port:"8081",
        inline: true//实时刷新
      } 
    }
    //package.json
      "scripts": {
        "test": "echo \"Error: no test specified\" && exit 1",
        "start":"webpack",
        "server": "webpack-dev-server --open"
      }
    

    执行 npm run server命令,浏览器输入地址,修改js源文件,浏览器自动刷新页面。


    image.png

    相关文章

      网友评论

        本文标题:【Webpack】简单运用

        本文链接:https://www.haomeiwen.com/subject/olgllctx.html