這篇文章給大家介紹怎么在Webpack中設(shè)置環(huán)境變量，內(nèi)容非常詳細(xì)，感興趣的小伙伴們可以參考借鑒，希望對大家能有所幫助。

公司主營業(yè)務(wù)：網(wǎng)站建設(shè)、做網(wǎng)站、移動網(wǎng)站開發(fā)等業(yè)務(wù)。幫助企業(yè)客戶真正實(shí)現(xiàn)互聯(lián)網(wǎng)宣傳，提高企業(yè)的競爭能力。創(chuàng)新互聯(lián)公司是一支青春激揚(yáng)、勤奮敬業(yè)、活力青春激揚(yáng)、勤奮敬業(yè)、活力澎湃、和諧高效的團(tuán)隊。公司秉承以“開放、自由、嚴(yán)謹(jǐn)、自律”為核心的企業(yè)文化，感謝他們對我們的高要求，感謝他們從不同領(lǐng)域給我們帶來的挑戰(zhàn)，讓我們激情的團(tuán)隊有機(jī)會用頭腦與智慧不斷的給客戶帶來驚喜。創(chuàng)新互聯(lián)公司推出珠暉免費(fèi)做網(wǎng)站回饋大家。

一、前言

• 日常的前端開發(fā)工作中，至少會有兩套構(gòu)建環(huán)境

• 一套開發(fā)時使用，構(gòu)建結(jié)果用于本地開發(fā)調(diào)試，不進(jìn)行代碼壓縮、打印 debug 信息、包含 sourcemap 文件等

• 一套發(fā)布時使用，構(gòu)建結(jié)果用于線上，即代碼都是壓縮過的、運(yùn)行時不打印 debug 信息、靜態(tài)文件不包括 sourcemap 等

• webpack 4.0 版本開始引入了 mode 的概念

二、區(qū)分開發(fā)環(huán)境/生產(chǎn)環(huán)境的多種方式

2.1 使用命令行

2.1.1 寫法一

"scripts": {
 // 默認(rèn) mode 為 development
 "dev1": "webpack-dev-server",
 // 默認(rèn) mode 為 production，不過這樣寫，打包的時候會有警告
 "build1": "webpack",
}

以上 script 腳本，可以在任意模塊內(nèi)通過 process.env.NODE_ENV 獲取當(dāng)前的環(huán)境變量

但無法在 node 環(huán)境（webpack 配置文件中）下獲取當(dāng)前的環(huán)境變量

// index.js 
function getEnv() {
 console.log(process.env.NODE_ENV);// development | production
}

// webpack.config.js
const path = require('path');
const webpack = require('webpack');

console.log('NODE_ENV',process.env.NODE_ENV);// undefined

module.exports = {
 	entry:'./src/index.js',
  output: {
   filename: 'js/[name].js'
  },
 		...
};

2.1.2 寫法二

"scripts": {
 "dev2": "webpack --mode=development",
 "build2": "webpack --mode=production",
}

和寫法一， 是一樣的結(jié)果

2.1.3 寫法三

"scripts": {
 "dev3": "webpack-dev-server --env=development",
 "build3": "webpack --env=production",
}

以上 script 腳本，無法在任意模塊內(nèi)通過 process.env.NODE_ENV 獲取當(dāng)前的環(huán)境變量

但可以在 node 環(huán)境（webpack 配置文件中）下，通過函數(shù)獲取當(dāng)前環(huán)境變量

// index.js 
function getEnv() {
 console.log(process.env.NODE_ENV);// undefined
}

// webpack.config.js
const path = require('path');
const webpack = require('webpack');

console.log('NODE_ENV',process.env.NODE_ENV);// undefined

// 通過函數(shù)獲取當(dāng)前環(huán)境變量
module.exports = (env,argv) => {
 console.log('env',env);// development | production
 return {
 	entry:'./src/index.js',
  output: {
   filename: 'js/[name].js'
  },
 		...
 }
};

2.2 使用 mode

// index.js 
function getEnv() {
  console.log(process.env.NODE_ENV);// development | production
}

// webpack.config.js
const path = require('path');
const webpack = require('webpack');

console.log('NODE_ENV',process.env.NODE_ENV);// undefined

module.exports = {
 	mode:'development',// development | production
 	entry:'./src/index.js',
    output: {
      filename: 'js/[name].js'
    },
  		...
};

和 2.1 中的寫法二，是一樣的結(jié)果

一個是在命令行中設(shè)置，一個是在 webpack 配置文件中設(shè)置

2.3 使用 webpack.DefinePlugin

首先得知道這個插件的作用：設(shè)置全局變量（并非掛載到 window 上），所有模塊都能讀取到該變量的值

// index.js 
function getEnv() {
  console.log(process.env.NODE_ENV);// development
  console.log(NODE_ENV);// production
}

// webpack.config.js
const path = require('path');
const webpack = require('webpack');

// 這里只是湊巧和環(huán)境變量同名了，所以才不會報錯
console.log('process.env.NODE_ENV',process.env.NODE_ENV);// undefined
console.log('NODE_ENV',NODE_ENV);// error ?。?！

module.exports = {
 	mode:'development',// development | production
 	entry:'./src/index.js',
    output: {
      filename: 'js/[name].js'
    },
 	plugins:[
      new webpack.DefinePlugin({
      	'process.env.NODE_ENV':JSON.stringify('development'),
        'NODE_ENV':JSON.stringify('production'),
    }),
  ],
  		...
};

可以在任意模塊內(nèi)通過 process.env.NODE_ENV 獲取當(dāng)前的環(huán)境變量

但無法在 node 環(huán)境（webpack 配置文件中）下獲取當(dāng)前的環(huán)境變量

2.4 使用 cross-env 插件

原先我一直以為這個插件，可以用來設(shè)置所有環(huán)境（瀏覽器環(huán)境、node 環(huán)境）下的變量。經(jīng)過測試發(fā)現(xiàn)，只能設(shè)置node 環(huán)境下的變量 —— NODE_ENV

2.4.1 寫法一

"scripts": {
 	"dev1": "cross-env NODE_ENV='production' webpack-dev-server",
    "build1": "cross-env NODE_ENV='development' webpack",
}

以上 script 腳本，可以在任意模塊內(nèi)通過 process.env.NODE_ENV 獲取當(dāng)前的環(huán)境變量

可以在 node 環(huán)境（webpack 配置文件中）下，獲取當(dāng)前環(huán)境變量

但是會有一個問題： 瀏覽器環(huán)境和 node 環(huán)境下獲取到的值是不一樣的

// ?。。。。。?
// npm run build1 
// ?。。。。。?

// index.js 
function getEnv() {
  console.log(process.env.NODE_ENV);// production
}

// webpack.config.js
const path = require('path');
const webpack = require('webpack');

console.log('process.env.NODE_ENV',process.env.NODE_ENV);// development

module.exports = {
 	entry:'./src/index.js',
    output: {
      filename: 'js/[name].js'
    },
  		...
};

2.4.2 寫法二

"scripts": {
 "dev2": "cross-env NODE_ENV='development' --mode development",
 "build2": "cross-env NODE_ENV='production' --mode production",
}

以上 script 腳本，可以在任意模塊內(nèi)通過 process.env.NODE_ENV 獲取當(dāng)前的環(huán)境變量

可以在 node 環(huán)境（webpack 配置文件中）下，獲取當(dāng)前環(huán)境變量

所以在能瀏覽器環(huán)境下讀取到環(huán)境變量的值，靠的是 mode ，在 node 環(huán)境下讀取到環(huán)境變量的值，靠的是 cross-env

// ！?。。。?！
// npm run build2 
// ?。。。。?！

// index.js 
function getEnv() {
  console.log(process.env.NODE_ENV);// production
}

// webpack.config.js
const path = require('path');
const webpack = require('webpack');

console.log('process.env.NODE_ENV',process.env.NODE_ENV);// production

module.exports = {
 	entry:'./src/index.js',
    output: {
      filename: 'js/[name].js'
    },
  		...
};

三、誤區(qū)

經(jīng)常在一些群里看到這個問題： cross-env 和 webpack.DefinePlugin 配合使用的時候，無法通過 process.env.xxx 來獲取到設(shè)置的環(huán)境變量，需要通過 webpack.DefinePlugin 里面設(shè)置的 key 來獲取。

會引發(fā)這個問題的可能原因是：先往 cross-env 里設(shè)置了 NODE_ENV 變量，然后又到 DefinePlugin里設(shè)置了一遍環(huán)境變量

"scripts": {
 "dev": "cross-env NODE_ENV='development' --mode development"
}

// index.js 
function getEnv() {
  console.log(process.env.NODE_ENV);// development
}

// webpack.config.js
const path = require('path');
const webpack = require('webpack');

console.log('process.env.NODE_ENV',process.env.NODE_ENV);// development

module.exports = {
 	entry:'./src/index.js',
    output: {
      filename: 'js/[name].js'
    },
 	plugins:[
      new webpack.DefinePlugin({
       	// 設(shè)置環(huán)境變量
        	'process.env.NODE_ENV':JSON.stringify('development'),
      }),
    ],
  		...
};

此時會發(fā)現(xiàn)瀏覽器環(huán)境和 node 環(huán)境都能獲取到設(shè)置的變量了，然后就認(rèn)為之后再設(shè)置其他的全局變量時，也像這樣寫就行了。

認(rèn)為 cross-env 和 DefinePlugin 是配套一起使用的，這個看法本身就很奇怪，因為兩者的作用點(diǎn)不一樣

• DefinePlugin 的作用：是設(shè)置瀏覽器環(huán)境下能讀取到的 "全局變量"，直接通過 key 讀取，在 node 環(huán)境下是無法讀取到的

• cross-env 的作用：是通過命令行設(shè)置環(huán)境變量 NODE_ENV，使 node 環(huán)境下能讀取到，通過 process.env.NODE_ENV 讀取

• 如果在DefinePlugin 里設(shè)置的 key 是 process.env.NODE_ENV ，會覆蓋 webpack 通過 mode 模式設(shè)置的環(huán)境變量的值

"scripts": {
 "dev": "cross-env NODE_ENV='development' --mode development"
}

// index.js 
function getEnv() {
  console.log(process.env.NODE_ENV);// 666666
}

// webpack.config.js
const path = require('path');
const webpack = require('webpack');

console.log('process.env.NODE_ENV',process.env.NODE_ENV);// development

module.exports = {
 	entry:'./src/index.js',
    output: {
      filename: 'js/[name].js'
    },
 	plugins:[
      new webpack.DefinePlugin({
        // 注意：因為同名的 key，這里的值會覆蓋默認(rèn)的值 ?。。。。。?
        	'process.env.NODE_ENV':JSON.stringify('666666'),
      }),
    ],
  		...
};

關(guān)于怎么在Webpack中設(shè)置環(huán)境變量就分享到這里了，希望以上內(nèi)容可以對大家有一定的幫助，可以學(xué)到更多知識。如果覺得文章不錯，可以把它分享出去讓更多的人看到。