Webpack + ES6 最新環境搭建與配置


一,准備工作

1.下載node.js 和 npm

2.將鏡像源替換為淘寶鏡像

 

二,創建目錄及安裝webpack

創建項目

在命令行中輸入 npm init -y

我們看到了項目中多了一個package.json文件,它定義了這個項目中所需各種模板及項目中的配置信息。該對象的每一個成員就是當前項目的一項設置。詳細設置信息請參考 https://docs.npmjs.com/files/package.json

安裝webpack

全局安裝webpack,在命令行輸入
npm install webpack -g
npm install webpack-cli -g
在webpack4中webpack和webpack-cli分開了,因此需要分開安裝

當前目錄下安裝一個webpack
在命令行輸入
npm install webpack-cli--save-dev
npm install webpack --save-dev

什么是全局安裝?

  其中參數-g的含義是代表安裝到全局環境里面,包安裝在Node安裝目錄下的node_modules文件夾中,一般在 \Users\用戶名\AppData\Roaming\ 目錄下,可以使用npm root -g查看全局安裝目錄。

全局安裝后可以供命令行(command line)使用,用戶可以在命令行中直接運行該組件包支持的命令,如下圖全局安裝cnpm后的cmd文件

什么是本地安裝

  本地安裝方式是輸入命令:npm install eslint 或 npm install eslint --save-dev等,其中參數--save-dev的含義是代表把你的安裝包信息寫入package.json文件的devDependencies字段中,包安裝在我們執行命令的根目錄下的node_modules文件夾下。本地安裝后可以直接通過require()的方式引入項目中node_modules目錄下的模塊,如下示例,本地安裝后直接在gulpfile.js中require('webpack')。如下圖

  我們在使用時,建議都使用本地安裝,本地安裝可以讓每個項目擁有獨立的包,不受全局包的影響,方便項目的移動、復制、打包等,保證不同版本包之間的相互依賴。缺點就是安裝時間較長,占用內存大,但是在磁盤越來越大的今天,他的缺點可以忽略。

 

使用webpack

1.我們在跟目錄下創建一個文件夾src來存放源文件
2.在創建一個文件夾build來存放編譯后的文件
3.新建index.html文件
4.創建配置文件webpack.config.js

創建index.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Hi webpack4!</title>
</head>
<body>
<script src = "../build/bundle.js"></script>
</body>
</html>

創建Main.js

document.write("<span>Hi webpack4 + ES6!</span>");

配置webpack.config.js

var path = require('path');
var appPath = path.resolve(__dirname, './src/Main.js');
var buildPath = path.resolve(__dirname, './build');
module.exports = {
    entry: appPath,//整個頁面的入口文件
    output: {
        path: buildPath,//打包輸出的地址
        filename: "bundle.js",//輸出的文件名稱
    },
    module: {
            }
}

在命令行輸入
webpack --mode development
bundle.js

webpack --mode development
bundle.js

webpack4中引入了生產和開發模式,
生產模式可以實現各種優化。 包括縮小,規模提升,tree-shaking等等,
開發模式針對速度進行了優化,只不過是提供未縮小的捆綁包

我們使用ES6的語法來試一試

//Main.js
import {Dog} from "./Dog";
class Main {
    constructor() {
        document.write("Hi webpack4 + ES6!");
        console.info("Hi webpack4  + ES6");
        let dog = new Dog();
    }
}
new Main();
//Dog.js
export class Dog{
    constructor(){
        console.info("wow wow");
    }
}

編譯后的bundle.js

打開index.html

webpack-v4.10.2會識別es6語法並編譯

 

我們也可以使用babel來對ES6進行編譯

輸入 npm install babel-loader --save-dev

修改配置項webpack.config.js

var path = require('path');
var appPath = path.resolve(__dirname, './src/Main.js');
var buildPath = path.resolve(__dirname, './build');
module.exports = {
    entry: appPath,//整個頁面的入口文件
    output: {
        path: buildPath,//打包輸出的地址
        filename: "bundle.js",//輸出的文件名稱
    },
    module: {
        rules: [
            {
                test: /\.js$/,
                loader: 'babel-loader?presets=es2015'
            }
        ]
    }
}

 

兩者的編譯結果存在部分差異,並不影響正確性。

 

 

三,webpack加載資源文件

根據模版文件生成訪問入口

我們在部署項目時,部署的是build中的文件,並不會將我們src/index.html作為訪問的入口,因此,我們需要將index.html移動到build下,但是簡單的復制過去是不行的,由於文件目錄的不同,如果使用了相對路徑,那么就會找不到文件。這時候我們就可以用到webpack的插件 html-webpack-plugin,它可以將我們src/index.html作為模版,生成一份新的index.html在build下。

具體的用法請查看
https://github.com/jantimon/html-webpack-plugin#third-party-addons
在本例只是簡單使用。

執行
npm i --save-dev html-webpack-plugin

之前我們是將index.html中的js入口指定為build/bundle.js,使用這個插件后,我們設置它直接指向Main.js

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Hi webpack4!</title>
</head>
<body>
<script src = "Main.js"></script>
</body>
</html>
/* webpack.config.js */
var path = require('path');
var appPath = path.resolve(__dirname, './src/Main.js');
var buildPath = path.resolve(__dirname, './build');
const HtmlWebpackPlugin = require('html-webpack-plugin')
module.exports = {
    entry: appPath,//整個頁面的入口文件
    output: {
        path: buildPath,//打包輸出的地址
        filename: "bundle.js",//輸出的文件名稱
    },
    module: {
        rules: [
            {
                test: /\.js$/,
                loader: 'babel-loader?presets=es2015'
            }
        ]
    },
    plugins: [
        new HtmlWebpackPlugin({
            /*
            template 參數指定入口 html 文件路徑,插件會把這個文件交給 webpack 去編譯,
            webpack 按照正常流程,找到 loaders 中 test 條件匹配的 loader 來編譯,那么這里 html-loader 就是匹配的 loader
            html-loader 編譯后產生的字符串,會由 html-webpack-plugin 儲存為 html 文件到輸出目錄,默認文件名為 index.html
            可以通過 filename 參數指定輸出的文件名
            html-webpack-plugin 也可以不指定 template 參數,它會使用默認的 html 模板。
            */
            template: './src/index.html',
            /*
            因為和 webpack 4 的兼容性問題,chunksSortMode 參數需要設置為 none
            https://github.com/jantimon/html-webpack-plugin/issues/870
            */
            chunksSortMode: 'none'
        }),
    ]
}

輸入指令打包我們會發現,build下的index.html已經生成,並且指向了編譯的后js

 

使用webpack打包圖片和文件

我們新增資源文件夾asset 並添加一張圖片

import {Dog} from "./Dog";
class Main {
    constructor() {
        document.write("Hi webpack4 + ES6!");
        console.info("Hi webpack4  + ES6");
        let dog = new Dog();
        document.write("<img src=\"./asset/atlas.png\"/>");
    }
}
new Main();

並將圖片展示到頁面

 

圖裂了,找不到資源,大家應該都猜到了,應為在編譯時,直接將<img src=\"./asset/atlas.png\"/> 添加到了build/index.html,build下並沒有asset包,所以找不到資源。難道我們需要在build下在建立一個資源文件夾嗎?答案是不用,webpack可以對圖片的路徑進行轉換和圖片打包。

輸入指令
npm install url-loader --save-dev
npm install file-loader --save-dev

/*webpack.config.js*/
var path = require('path');
var appPath = path.resolve(__dirname, './src/Main.js');
var buildPath = path.resolve(__dirname, './build');
const HtmlWebpackPlugin = require('html-webpack-plugin')
module.exports = {
    entry: appPath,//整個頁面的入口文件
    output: {
        path: buildPath,//打包輸出的地址
        filename: "bundle.js",//輸出的文件名稱
    },
    module: {
        rules: [
            {
                test: /\.js$/,
                loader: 'babel-loader?presets=es2015'
            } ,
            {
                //url-loader的主要功能是:將源文件轉換成DataUrl(聲明文件mimetype的base64編碼)
                //小於limit字節,以 base64 的方式引用,大於limit就交給file-loader處理了
                //file-loader的主要功能是:把源文件遷移到指定的目錄(可以簡單理解為從源文件目錄遷移到build目錄
                test: /\.(jpg|png|gif)$/,
                loader: 'url-loader?limit=8192&name=asset/[hash:8].[name].[ext]'
            }
        ]
    },
    plugins: [
        new HtmlWebpackPlugin({
            /*
            template 參數指定入口 html 文件路徑,插件會把這個文件交給 webpack 去編譯,
            webpack 按照正常流程,找到 loaders 中 test 條件匹配的 loader 來編譯,那么這里 html-loader 就是匹配的 loader
            html-loader 編譯后產生的字符串,會由 html-webpack-plugin 儲存為 html 文件到輸出目錄,默認文件名為 index.html
            可以通過 filename 參數指定輸出的文件名
            html-webpack-plugin 也可以不指定 template 參數,它會使用默認的 html 模板。
            */
            template: './src/index.html',
            /*
            因為和 webpack 4 的兼容性問題,chunksSortMode 參數需要設置為 none
            https://github.com/jantimon/html-webpack-plugin/issues/870
            */
            chunksSortMode: 'none'
        }),
    ]
}

編譯后的目錄如下(新增一張較大的圖片book用於展示file-loader)

頁面效果如下,圖是隨便找的,見諒。

注意:當我們引入一些資源需要使用變量引用時,像這樣引用的話是會編譯失敗的

圖片並沒有像上圖一樣打包到asset中

當我們在require一個模塊的時候,如果在require中包含變量,像這樣:
require("./asset/" + name + ".png");
那么在編譯的時候我們是不能知道具體的模塊的。但這個時候,webpack也會為我們做些分析工作:
1.分析目錄:'./asset'; 
2.提取正則表達式:'/^.*\.png$/';
於是這個時候為了更好地配合wenpack進行編譯,我們應該給它指明路徑

使用webpack打包css文件

就像圖片一樣,webpack也提供了樣式文件的打包,
npm install style-loader --save-dev
npm install css-loader --save-dev

//rules中添加
{
//css-loader使能夠使用類似@import和url(...)的方法實現require,style-loader將所有的計算后的樣式加入頁面中
//webpack肯定是先將所有css模塊依賴解析完得到計算結果再創建style標簽。因此應該把style-loader放在css-loader的前面
test: /\.css$/,
use: ['style-loader', 'css-loader']
}

添加main.css文件,
span{color:red;}
目錄如下

 四,搭建webpack微服務器

在開發過程中,我們不可能修改一次,打包一次。因此我們需要使用到webpack提供的服務器。
cnpm install webpack-dev-server --save-dev

為了方便我們在pack.json中配置腳本。
"start":"webpack-dev-server--modedevelopment",
"dev":"webpack--modedevelopment",
"build":"webpack--modeproduction"

npm run start

啟動成功后訪問服務地址,就可以實現修改代碼之后,頁面實時刷新。

啟動時使用的是默認配置。

當我們需要個性化設置時,在webpack.config.js中添加設置即可

//以下是服務環境配置
devServer:{
port:8085,//端口
host:'localhost',//地址
inline:true,//用來支持dev-server自動刷新
open:true,//開啟webpack-dev-server時自動打開頁面
historyApiFallback:true,
contentBase:path.resolve(__dirname),//用來指定index.html所在目錄
publicPath:'/build/',//用來指定編譯后的bundle.js的目錄
openPage:"build/index.html"//指定打開的頁面
}

這樣,一個簡單的webpack4 + ES6的開發環境就搭建完畢。

 


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM