【webpack4】用不同语言语法编写webpack配置文件

写在前面

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。所以我们在编程的时候,都需要安装编译器的相关依赖,并且在必要的时候,还需要对编译器进行配置。

相关推荐