写在前面
webpack配置文件默认情况下为webpack.config.js
,即用原生js语法书写的配置文件。
然而,在我们的项目中,有时候是使用的是其他语言语法进行编程,例如:es6、coffeeScript、typeScript等语言语法。
为此,webpack为我们提供了可以采用不同语言语法类型书写配置文件的功能。
具体可以支持的文件拓展可以看这里:https://github.com/gulpjs/int…
可以看到,webpack为我们提供了丰富多样可供选择的文件拓展。
下面介绍一下最常见的webpack配置文件类型:
TypeScript
1、安装依赖
如果想要使用TypeScript来书写webpack配置文件,首先要先安装依赖:
npm install –save-dev typescript ts-node @types/node @types/webpack
如果需要用到webpack-dev-server,还需要安装:
npm install –save-dev @types/webpack-dev-server
2、编写webpack配置文件
(1)把webpack配置文件的文件名改为:webpack.config.ts
TypeScript的文件拓展名为.ts,所以我们需要同时把webpack配置文件的文件名改为.ts拓展名(原来默认为webpack.config.js)
当我们把webpack配置文件名拓展改为.ts时,webpack也会自动读取该拓展名下的文件。即不需要这样设置:
>> webpack –config webpack.config.ts
webpack会自动帮我们读取webpack.config.ts文件,不需要我们再去设置了
(2)编写webpack.config.ts
配置文件
利用TypeScript编写webpack配置文件时,webpack配置文件的结构同以前一样,只不过语言变为Typescript而已。
//webpack.config.ts
import path from 'path'
import webpack from 'webpack'
?
const config: webpack.Configuration = {
entry: './src/index.js',
output: {
filename: 'bundle.js',
path: path.resolve(__dirname, 'dist'),
publicPath: path.resolve(__dirname, 'dist'),
},
}
export default config
在本webpack配置文件webpack.config.ts
中,我们把require语法改为ts中的import、export静态模块引入导出的语法,以便我们测试。
3、编写TypeScript配置文件
通常来说,大多情况下,我们使用某种语法、插件等,它都会有自己一份默认的配置,在比较简单的项目中,毋需我们编写配置文件。
但是,在利用TypeScript书写webpack配置文件时,我们还需要额外编写TypeScript配置文件tsconfig.json:
{
"compilerOptions": {
/* ts-node只支持commonjs规范 */
"module": "commonjs",
"target": "es5",
"esModuleInterop": true,
}
}
这是因为我们在前面安装的依赖ts-node
不支持commonjs之外的模块语法,所以我们必须在TypeScript的配置文件tsconfig.json配置compilerOptions中module字段为:commonjs,
否则,webpack会报错。
ps:在安装依赖的时候,我们也需要考虑依赖的局限性。比如某些依赖依赖于其他的依赖,在项目开发的时候,我们需要把其涉及到的其他依赖一同安装。另外,依赖不是万能的,在确定安装依赖的时候,需要额外去学习该依赖相关知识。
coffeeScript
1、安装依赖
与上面的内容相似,首先我们需要安装相关依赖:
npm install –save-dev coffee-script
2、编写webpack配置文件
(1)把webpack配置文件的文件名改为:webpack.config.coffee
CoffeeScript的文件拓展名为.coffee,所以我们需要同时把webpack配置文件的文件名改为.coffee拓展名(原来默认为webpack.config.js
)
当我们把webpack配置文件名拓展改为.coffee时,webpack也会自动读取该拓展名下的文件。即不需要这样设置:
webpack –config webpack.config.coffee
webpack会自动帮我们读取webpack.config.coffee文件,不需要我们再去设置
(2)利用coffeeScript重新编写webpack.config.coffee
文件
//webpack.config.coffee
webpack = require('webpack')
path = require('path')
config =
mode: 'production'
entry: './src/index.js'
output:
path: path.resolve(__dirname, 'dist')
filename: 'bundle.js'
module.exports = config
用coffeeScript编写webpack配置文件时,毋需向TypeScript一样编写ts配置文件,因为coffeeScript安装的依赖没有其他的兼容性问题出现。
ES6
利用es6写webpack配置文件的原理同上面一样,都是把其他类型的语言语法编译成原生js。把es6编译成原生js可以使用babel进行编译(也有其他选择)。
1、安装依赖
npm install –save-dev babel-core babel-loader babel-preset-es2015 babel-preset-stage-3
其中,要使用babel编译器,我们需要安装的依赖有babel-core。babel-core包中囊括了babel的核心方法。
2、编写webpack配置文件
由于es6语法写的文件名拓展也是.js,那么webpack如何识别该js文件,并把它交予babel进行编译呢?
(1)webpack.config.[loader].js
把webpack配置文件的文件名改为webpack.config.babel.js,其中babel字段表示需要优先使用babel-loader对该webpack配置文件进行编译。同样地,我们可以把webpack.config.[loader].js中的[loader]替换成我们需要的loader名。
这也是我们需要安装babel-loader
的原因。
(2)编写webpack.config.babel.js
为了体现es6语法,我们把webpack配置文件改写成:
import path from 'path'
// example of an imported plugin
const CustomPlugin = config => ({
...config,
name: 'custom-plugin'
});
?
export default {
entry: './src/index.js',
output: {
filename: 'bundle.js',
path: path.resolve(__dirname, 'dist')
},
}
其中,import、export、… 语法为es6语法
3、编写babel配置文件.babelrc
babel实质是一个支持众多语法编译转化的编译器,为了保证babel的可拓展性,作者把babel设计成可以灵活配置,支持安装插件的模式。因此,我们需要自行配置babel,使之支持es6编译。
{
"presets": [ "es2015", "stage-3"],
}
其中,我们需要安装babel-preset-es2015
的包,使得babel支持es6编译。
另外,使用...config
语法需要安装babel-preset-stage-3
包,否则会编译错误。
总之,我们可以使用各种各样的语言语法来编写webpack配置文件,它们的原理都是使用对应的编译器编译成原生的js。所以我们在编程的时候,都需要安装编译器的相关依赖,并且在必要的时候,还需要对编译器进行配置。