Version: 2.x

编译配置详情

designWidth

designWidth 用来设置设计稿尺寸，关于这一部分的配置说明请见设计稿及尺寸单位这一章节。

sourceRoot

sourceRoot 用来设置源码存放目录，通过 Taro 开发工具初始化后的项目源码目录都是 src，你可以通过修改这一配置来重新指定源码目录。

outputRoot

outputRoot 用来设置代码编译后的生产目录，通过 Taro 开发工具初始化后的生产目录都是 dist，你可以通过修改这一配置来重新指定生产目录。

plugins

自 2.2 开始，Taro 引入了插件化机制，允许开发者通过编写插件的方式来为 Taro 拓展更多功能或者为自身业务定制个性化功能

plugins 用来配置 Taro 插件。

plugins 字段取值为一个数组，配置方式如下：

const config = {
  plugins: [
    // 引入 npm 安装的插件
    '@tarojs/plugin-mock',
    // 引入 npm 安装的插件，并传入插件参数
    ['@tarojs/plugin-mock', {
      mocks: {
        '/api/user/1': {
          name: 'judy',
          desc: 'Mental guy'
        }
      }
    }],
    // 从本地绝对路径引入插件，同样如果需要传入参数也是如上
    '/absulute/path/plugin/filename',
  ]
}

presets

如果你有一系列插件需要配置，而他们通常是组合起来完成特定的事儿，那你可以通过插件集 presets 来进行配置。

配置编译配置中的 presets 字段，如下。

const config = {
  presets: [
    // 引入 npm 安装的插件集
    '@tarojs/preset-sth', 
    // 引入 npm 安装的插件集，并传入插件参数
    ['@tarojs/plugin-sth', {
      arg0: 'xxx'
    }],
    // 从本地绝对路径引入插件集，同样如果需要传入参数也是如上
    '/absulute/path/preset/filename',
  ]
}

babel

用来配置 babel，默认配置如下，可以自行添加自己需要的额外的 presets 及 plugins。

babel: {
  sourceMap: true,
  presets: [
    'env'
  ],
  plugins: [
    'transform-class-properties',
    'transform-decorators-legacy',
    'transform-object-rest-spread'
  ]
}

uglify

自 2.2.8 开始，需要安装 @tarojs/plugin-uglify 插件才能使用此配置

用来配置 UgligyJS 工具，设置打包过程中的 JS 代码压缩。可以通过 uglify.enable 来设置是否开启压缩，若设置开启，则可以通过 uglify.config 来设置 UgligyJS 的配置项，具体配置方式如下：

uglify: {
  enable: true,
  config: {
    // 配置项同 https://github.com/mishoo/UglifyJS2#minify-options
  }
}

terser

自 2.2.8 开始，需要安装 @tarojs/plugin-terser 插件才能使用此配置

用来配置 terser 工具，设置打包过程中的 JS 代码压缩。可以通过 terser.enable 来设置是否开启压缩，若设置开启，则可以通过 terser.config 来设置 terser 的配置项，具体配置方式如下：

terser: {
  enable: true,
  config: {
    // 配置项同 https://github.com/terser/terser#minify-options
  }
}

csso

用来配置 csso 工具，设置打包过程中的 CSS 代码压缩。可以通过 csso.enable 来设置是否开启压缩，若设置开启，则可以通过 csso.config 来设置 csso 的配置项，具体配置方式如下：

csso: {
  enable: true,
  config: {
    // 配置项同 https://github.com/css/csso#minifysource-options
  }
}

sass

自 2.2.8 开始，需要安装 @tarojs/plugin-sass 插件才能使用此配置

用来配置 sass 工具，设置打包过程中的 SCSS 代码编译。
具体配置可以参考node-sass
当需要全局注入scss文件时，可以添加三个额外参数：resource 、 projectDirectory (v1.2.25开始支持)、data（v1.3.0开始支持），具体配置方式如下：

单文件路径形式

当只有 resource 字段时，可以传入 scss 文件的绝对路径。

sass: {
  resource: path.resolve(__dirname, '..', 'src/styles/variable.scss')
}

多文件路径形式

此外，当只有 resource 字段时，也可以传入一个路径数组。

sass: {
  resource: [
    path.resolve(__dirname, '..', 'src/styles/variable.scss'),
    path.resolve(__dirname, '..', 'src/styles/mixins.scss')
  ]
}

指定项目根目录路径形式

你可以额外配置 projectDirectory 字段，这样你就可以在 resource 里写相对路径了。

sass: {
  resource: [
    'src/styles/variable.scss',
    'src/styles/mixins.scss'
  ],
  projectDirectory: path.resolve(__dirname, '..')
}

传入 scss 变量字符串

sass: {
  resource: [
    'src/styles/variable.scss',
    'src/styles/mixins.scss'
  ],
  projectDirectory: path.resolve(__dirname, '..'),
  data: '$nav-height: 48px;'
}

resource: 如果要引入多个文件，支持数组形式传入
projectDirectory: 项目根目录的绝对地址(若为小程序云开发模板，则应该是client目录)
data: 全局 scss 变量，若 data 与 resource 中设置了同样的变量，则 data 的优先级高于 resource

env

用来设置一些环境变量如 process.env.NODE_ENV，例如我们想设置区分预览、打包来做些不同的操作，可以如下配置：

在 config/dev.js 中：

env: {
  NODE_ENV: '"development"' // JSON.stringify('development')
}

在 config/prod.js 中：

env: {
  NODE_ENV: '"production"' // JSON.stringify('production')
}

这样就能在代码中通过 process.env.NODE_ENV === 'development' 来判断环境。

注意 Taro 在小程序中只暴露 TARO_ENV 以及在 config/* 下配置文件中 env 字段定义的环境变量，若需要通过 npm script 的方式通过命令行设置环境变量，可在 config/* 下配置文件中获取到对应的值，然后设置到配置文件中：

在 config/dev.js 中:

env: {
  CUSTOM_ENV: `"${process.env.CUSTOM_ENV}"`
}

在yarn/npm中：

"scripts": {
  "custom_command": "cross-env CUSTOM_ENV=xxx yarn dev:weapp"
}

defineConstants

用来配置一些全局变量供代码中进行使用，配置方式与 Webpack DefinePlugin 类似，例如：

defineConstants: {
  A: JSON.stringify('a') // '"a"'
}

alias

1.2.0 开始支持。

用来配置目录别名，从而方便书写代码引用路径。例如，使用相对路径书写文件引用如下：

import A from '../../componnets/A'
import Utils from '../../utils'
import packageJson from '../../package.json'
import projectConfig from '../../project.config.json'

为了避免书写多级相对路径，我们可以如下配置 alias：

alias: {
  '@/components': path.resolve(__dirname, '..', 'src/components'),
  '@/utils': path.resolve(__dirname, '..', 'src/utils'),
  '@/package': path.resolve(__dirname, '..', 'package.json'),
  '@/project': path.resolve(__dirname, '..', 'project.config.json'),
}

通过上述配置，可以将 src/components 和 src/utils 目录配置成别名，将根目录下的 package.json 和 project.config.json 文件配置成别名，则代码中的引用改写如下：

import A from '@/components/A'
import Utils from '@/utils'
import packageJson from '@/package'
import projectConfig from '@/project'

为了让编辑器（VS Code）不报错，并继续使用自动路径补全的功能，需要在项目根目录下的 jsconfig.json 或者 tsconfig.json 中配置 paths 让编辑器认得我们的别名，形式如下：

{
  "compilerOptions": {
    "baseUrl": ".",
    "paths": {
      "@/components/*": ["./src/components/*"],
      "@/utils/*": ["./src/utils/*"],
      "@/package": ["./package.json"],
      "@/project": ["./project.config.json"],
    }
  }
}

建议别名使用 @/ 开头而非仅用 @ 开头，因为有小概率会与某些 scoped 形式的 npm 包（行如：@tarojs/taro, @babel/core）产生命名冲突。

copy

文件 copy 配置，包含两个配置项 patterns 和 options。

copy.patterns

用来指定需要拷贝的文件或者目录，数组类型，每一项都必须包含 from 、to 的配置，分别代表来源和需要拷贝到的目录，同时可以设置 ignore 配置来指定需要忽略的文件， ignore 是指定的 glob 类型字符串，或者 glob 字符串数组。

值得注意的是，目前 from 必须指定存在的文件或者目录，暂不支持 glob 格式， from 和 to 直接置顶项目根目录下的文件目录，建议 from 以 src 目录开头，to 以 dist 目录开头。

一般有如下的使用形式：

copy: {
  patterns: [
    { from: 'src/asset/tt/', to: 'dist/asset/tt/', ignore: '*.js' }, // 指定需要 copy 的目录
    { from: 'src/asset/tt/sd.jpg', to: 'dist/asset/tt/sd.jpg' } // 指定需要 copy 的文件
  ]
},

copy.options

拷贝配置，目前可以指定全局的 ignore：

copy: {
  options: {
    ignore: ['*.js', '*.css'] // 全局的 ignore
  }
}

mini

专属于小程序的配置。

mini.compile

小程序编译过程的相关配置。

mini.compile.exclude

配置小程序编译过程中排除不需要经过 Taro 编译的文件，数组类型，数组里面可以包含具体文件路径，也可以是判断函数，同 Rule.exclude

例如，想要排除某个文件，可以如下配置要排除的文件具体路径：

const config = {
  mini: {
    compile: {
      exclude: [
        path.resolve(__dirname, '..', 'src/pages/index/vod-wx-sdk-v2.js')
      ]
    }
  }
}

也可以配置判断函数，如下

const config = {
  mini: {
    compile: {
      exclude: [
        function (modulePath) {
          return modulePath.indexOf('vod-wx-sdk-v2') >= 0
        }
      ]
    }
  }
}

mini.compile.include

配置额外需要经过 Taro 编译的文件，例如 Taro 默认不编译 node_modules 包中文件，可以通过这个配置让 Taro 编译 node_modules 包中文件，使用方式与 mini.compile.exclude 一致，同 Rule.include。

mini.webpackChain

自定义 Webpack 配置，接受函数形式的配置。

这个函数会收到三个参数，第一个参数是 webpackChain 对象，可参考 webpack-chain 的 api 进行修改；第二个参数是 webpack 实例；第三个参数 PARSE_AST_TYPE 是小程序编译时的文件类型集合。例如：

// 这是一个添加 raw-loader 的例子，用于在项目中直接引用 md 文件
{
  webpackChain (chain, webpack) {
    chain.merge({
      module: {
        rules: {
          myloader: {
            test: /\.md$/,
            use: [{
              loader: 'raw-loader',
              options: {}
            }]
          }
        }
      }
    })
  }
}

// 这是一个添加插件的例子
{
  webpackChain (chain, webpack) {
    chain.merge({
      plugin: {
        install: {
          plugin: require('npm-install-webpack-plugin'),
          args: [{
            // Use --save or --save-dev
            dev: false,
            // Install missing peerDependencies
            peerDependencies: true,
            // Reduce amount of console logging
            quiet: false,
            // npm command used inside company, yarn is not supported yet
            npm: 'cnpm'
          }]
        }
      }
    })
  }
}

注意：第三个参数的取值如下

export enum PARSE_AST_TYPE {
  ENTRY = 'ENTRY',
  PAGE = 'PAGE',
  COMPONENT = 'COMPONENT',
  NORMAL = 'NORMAL',
  STATIC = 'STATIC'
}

mini.commonChunks

type commonChunks = string[] | ((commonChunks: string[]) => string[])

配置打包时抽离的公共文件

支持两种配置方式，其一是字符串数组，给定抽离公共文件名，在 Taro 编译中，如果是普通编译，则 commonChunks 默认值为 ['runtime', 'vendors', 'taro', 'common']，如果是编译为微信小程序插件，则 commonChunks 默认值为 ['plugin/runtime', 'plugin/vendors', 'plugin/taro', 'plugin/common']，普通编译时默认配置

const config = {
  mini: {
    commonChunks: ['runtime', 'vendors', 'taro', 'common']
  }
}

这几个公共文件分别表示：

runtime: webpack 运行时入口
vendors: node_modules 中文件抽离
taro: node_modules 中 Taro 相关依赖抽离
common: 项目中业务代码公共文件抽离

其二是函数，通过对入参的默认公共文件数组进行操作，返回新的数组来进行配置，如下

const config = {
  mini: {
    commonChunks (commonChunks) {
      // commonChunks 的取值即为默认的公共文件名数组
      commonChunks.push('yourCustomCommonChunkName')
      return commonChunks
    }
  }
}

commonChunks 的配置值主要依据 webpack 配置 optimization.runtimeChunk 和 optimization.splitChunks，Taro 中默认的配置分别为

optimization: {
  runtimeChunk: {
    name: 'runtime'
  },
  splitChunks: {
    chunks: 'all',
    maxInitialRequests: Infinity,
    minSize: 0,
    name: 'vendors',
    cacheGroups: {
      common: {
        name: !!config.isBuildPlugin ? 'plugin/common' : 'common',
        minChunks: 2,
        priority: 1
      },
      vendors: {
        name: !!config.isBuildPlugin ? 'plugin/vendors' : 'vendors',
        minChunks: 2,
        test: module => {
          // 如果需要自定义配置，PARSE_AST_TYPE 可以从 webpackChain 第三个参数获得
          return /[\\/]node_modules[\\/]/.test(module.resource) && module.miniType !== PARSE_AST_TYPE.COMPONENT
        },
        priority: 10
      },
      taro: {
        name: !!config.isBuildPlugin ? 'plugin/taro' : 'taro',
        test: module => {
          // buildAdapter 为当前编译的端，在配置文件中可以通过 process.env.TARO_ENV 来获取
          const taroBaseReg = new RegExp(`@tarojs[\\/]taro|@tarojs[\\/]${buildAdapter}`)
          return taroBaseReg.test(module.context)
        },
        priority: 100
      }
    }
  }
}

如果有自行拆分公共文件的需求，请先通过 webpackChain 配置覆盖 optimization.runtimeChunk 与 optimization.splitChunks 配置，再通过 commonChunks 配置指定的公共入口文件。

mini.addChunkPages

2.0.5 开始支持 type addChunkPages = ((pages: Map<string, string[]>, pagesNames?: string[]) => void)

在某些情况下，我们可能需要为某些页面单独指定需要引用的公共文件，例如，使用小程序分包的时候，为了减少主包大小，分包的页面希望引入自己的公共文件，而不希望直接放在主包内，那么我们首先可以通过配置 mini.webpackChain 来单独抽离分包的公共文件，然后通过 mini.addChunkPages 为分包页面配置引入子包公共文件，其使用方式如下：

mini.addChunkPages 配置为一个函数，接受两个参数

pages 参数为 Map 类型，用于为页面添加公共文件
pagesNames 参数为当前应用的所有页面标识列表，可以通过打印的方式进行查看页面的标识

例如，为 pages/index/index 页面添加 eating 和 morning 两个抽离的公共文件

const config = {
  mini: {
    addChunkPages (pages, pagesNames) {
      pages.set('pages/index/index', ['eating', 'morning'])
    }
  }
}

mini.cssLoaderOption

css-loader 的附加配置。配置项参考官方文档，例如：

{
  cssLoaderOption: {
    localIdentName: '[hash:base64]'
  }
}

mini.styleLoaderOption

style-loader 的附加配置。配置项参考官方文档，例如：

{
  styleLoaderOption: {
    insertAt: 'top'
  }
}

mini.sassLoaderOption

自 2.2.8 开始，需要安装 @tarojs/plugin-sass 插件才能使用此配置

sass-loader 的附加配置。配置项参考官方文档，例如：

{
  sassLoaderOption: {
    implementation: require("dart-sass")
  }
}

mini.lessLoaderOption

自 2.2.8 开始，需要安装 @tarojs/plugin-less 插件才能使用此配置

less-loader 的附加配置。配置项参考官方文档，例如：

{
  lessLoaderOption: {
    strictMath: true,
    noIeCompat: true
  }
}

mini.stylusLoaderOption

自 2.2.8 开始，需要安装 @tarojs/plugin-stylus 插件才能使用此配置

stylus-loader 的附加配置。配置项参考官方文档。

mini.mediaUrlLoaderOption

针对 mp4 | webm | ogg | mp3 | wav | flac | aac 文件的 url-loader 配置。配置项参考官方文档，例如：

{
  mediaUrlLoaderOption: {
    limit: 8192
  }
}

mini.fontUrlLoaderOption

针对 woff | woff2 | eot | ttf | otf 文件的 url-loader 配置。配置项参考官方文档。

mini.imageUrlLoaderOption

针对 png | jpg | jpeg | gif | bpm | svg 文件的 url-loader 配置。配置项参考官方文档。

mini.miniCssExtractPluginOption

mini-css-extract-plugin 的附加配置，在 enableExtract 为 true 的情况下生效。配置项参考官方文档，例如：

{
  miniCssExtractPluginOption: {
    filename: '[name].css',
    chunkFilename: '[name].css'
  }
}

mini.postcss

配置 postcss 相关插件：

postcss: {
  // 可以进行 autoprefixer 的配置。配置项参考官方文档 https://github.com/postcss/autoprefixer
  autoprefixer: {
    enable: true,
    config: {
      // autoprefixer 配置项
    }
  },
  pxtransform: {
    enable: true,
    config: {
      // pxtransform 配置项，参考尺寸章节
      selectorBlackList: ['body']
    }
  },
  // 小程序端样式引用本地资源内联
  url: {
    enable: true,
    config: {
      limit: 10240 // 设定转换尺寸上限
    }
  },
  // css modules 功能开关与相关配置
  cssModules: {
    enable: false, // 默认为 false，如需使用 css modules 功能，则设为 true
    config: {
      generateScopedName: '[name]__[local]___[hash:base64:5]'
    }
  }
}

h5

专属于 H5 的配置。

h5.devServer

预览服务的配置，可以更改端口等参数。具体配置参考 webpack-dev-server。

devServer: {
  port: 10086
}

默认是 http 服务，如果想开启 https 服务需要做如下配置。

devServer: {
  https: true
}

h5.output

输出配置

output: {
  filename: 'js/[name].[hash:8].js',
  chunkFilename: 'js/[name].[chunkhash:8].js'
}

h5.publicPath

设置输出解析文件的目录。

h5.staticDirectory

h5 编译后的静态文件目录。

h5.chunkDirectory

编译后非 entry 的 js 文件的存放目录，主要影响动态引入的 pages 的存放路径。

h5.webpackChain

自定义 Webpack 配置，接受函数形式的配置。

这个函数会收到两个参数，第一个参数是 webpackChain 对象，可参考 webpack-chain 的 api 进行修改；第二个参数是 webpack 实例。例如：

// 这是一个添加 ts-loader 的例子，但事实上 taro 是默认支持 ts 的，并不需要这样做。
{
  webpackChain (chain, webpack) {
    chain.merge({
      module: {
        rule: {
          myloader: {
            test: /.tsx?/,
            use: [{
              loader: 'ts-loader',
              options: {}
            }]
          }
        }
      }
    })
  }
}

// 这是一个添加插件的例子
{
  webpackChain (chain, webpack) {
    chain.merge({
      plugin: {
        install: {
          plugin: require('npm-install-webpack-plugin'),
          args: [{
            // Use --save or --save-dev
            dev: false,
            // Install missing peerDependencies
            peerDependencies: true,
            // Reduce amount of console logging
            quiet: false,
            // npm command used inside company, yarn is not supported yet
            npm: 'cnpm'
          }]
        }
      }
    })
  }
}

h5.router

路由相关的配置，支持路由模式、路由基准路径以及自定义路由的配置。

h5.router.mode

路由模式配置。配置值为 hash（默认值）或 browser，分别对应 hash 路由模式和浏览器 history 路由模式。例子：

h5: {
  /* 其他配置 */
  ... ,
  router: {
    mode: 'hash' // 或者是 'browser'
  }
}

针对上面的配置，调用 Taro.navigateTo({ url: '/pages/index/index' }) 后，浏览器地址栏将被变为 https://{{domain}}/#/pages/index/index（hash 模式）或者 https://{{domain}}/pages/index/index（browser 模式）。

h5.router.basename

路由基准路径的配置，配置值为 string 类型。例子：

h5: {
  /* 其他配置 */
  ... ,
  router: {
    basename: '/myapp'
  }
}

针对上面的配置，调用 Taro.navigateTo({ url: '/pages/index/index' }) 后，浏览器地址栏将被变为 https://{{domain}}/#/myapp/pages/index/index（hash 模式）或者 https://{{domain}}/myapp/pages/index/index（browser 模式）。

h5.router.customRoutes

自定义路由的配置，配置值为 { [key: string]: string } 类型。例子：

h5: {
  /* 其他配置 */
  ... ,
  router: {
    customRoutes: {
      '/pages/index/index': '/index'
    }
  }
}

针对上面的配置，调用 Taro.navigateTo({ url: '/pages/index/index' }) 后，浏览器地址栏将被变为 https://{{domain}}/#/index（hash 模式）或者 https://{{domain}}/myapp/index（browser 模式）。

h5.entry

Taro app 的入口，同 webpack.entry。

{
  entry: {
    home: ['./home.js'],
    about: ['./about.js'],
    contact: ['./contact.js']
  }
}

h5.enableSourceMap

sourceMap 开关，影响 js、css 的 sourceMap 配置。 dev 状态默认开，prod 状态默认关。

h5.sourceMapType

sourceMap格式, 默认cheap-module-eval-source-map。具体配置

h5.enableExtract

extract 功能开关，开启后将使用 mini-css-extract-plugin 分离 css 文件，可通过 h5.miniCssExtractPluginOption 对插件进行配置。 dev 状态默认关，prod 状态默认开。

h5.esnextModules

配置需要额外的编译的源码模块，比如 taro-ui：

h5: {
  // 经过这一配置之后，代码中引入的处于 `node_modules/taro-ui/` 路径下的源码文件均会经过taro的编译处理。
  esnextModules: ['taro-ui'],
  ...
}

h5.cssLoaderOption

css-loader 的附加配置。配置项参考官方文档，例如：

{
  cssLoaderOption: {
    localIdentName: '[hash:base64]'
  }
}

h5.styleLoaderOption

style-loader 的附加配置。配置项参考官方文档，例如：

{
  styleLoaderOption: {
    insertAt: 'top'
  }
}

h5.sassLoaderOption

自 2.2.8 开始，需要安装 @tarojs/plugin-sass 插件才能使用此配置

sass-loader 的附加配置。配置项参考官方文档，例如：

{
  sassLoaderOption: {
    implementation: require("dart-sass")
  }
}

h5.lessLoaderOption

自 2.2.8 开始，需要安装 @tarojs/plugin-less 插件才能使用此配置

less-loader 的附加配置。配置项参考官方文档，例如：

{
  lessLoaderOption: {
    strictMath: true,
    noIeCompat: true
  }
}

h5.stylusLoaderOption

自 2.2.8 开始，需要安装 @tarojs/plugin-stylus 插件才能使用此配置

stylus-loader 的附加配置。配置项参考官方文档。

h5.mediaUrlLoaderOption

针对 mp4 | webm | ogg | mp3 | wav | flac | aac 文件的 url-loader 配置。配置项参考官方文档，例如：

{
  mediaUrlLoaderOption: {
    limit: 8192
  }
}

h5.fontUrlLoaderOption

针对 woff | woff2 | eot | ttf | otf 文件的 url-loader 配置。配置项参考官方文档。

h5.imageUrlLoaderOption

针对 png | jpg | jpeg | gif | bpm | svg 文件的 url-loader 配置。配置项参考官方文档。

h5.miniCssExtractPluginOption

mini-css-extract-plugin 的附加配置，在 enableExtract 为 true 的情况下生效。配置项参考官方文档，例如：

{
  miniCssExtractPluginOption: {
    filename: 'css/[name].css',
    chunkFilename: 'css/[id].css'
  }
}

h5.postcss

配置 H5 的 postcss 插件。

h5.postcss.autoprefixer

可以进行 autoprefixer 的配置。配置项参考官方文档，例如：

postcss: {
  autoprefixer: {
    enable: true,
    config: {
      /* autoprefixer 配置项 */
    }
  }
}

h5.postcss.pxtransform

可以进行 pxtransform 的配置。配置项参考官方文档，例如：

postcss: {
  pxtransform: {
    enable: true,
    config: {
      /* pxtransform 配置项 */
    }
  }
}

h5.postcss.cssModules

可以进行 H5 端 CSS Modules 配置，配置如下：

postcss: {
  // css modules 功能开关与相关配置
  cssModules: {
    enable: false, // 默认为 false，如需使用 css modules 功能，则设为 true
    config: {
      namingPattern: 'module',
      generateScopedName: '[name]__[local]___[hash:base64:5]'
    }
  }
}

rn

专属于 RN 的配置。

rn.appJSON

React Native 的 app.json 配置。

rn.compile

RN 编译过程的相关配置。

rn.compile.exclude

配置 RN 编译过程中排除不需要经过 Taro 编译的文件，数组类型，数组里面可以包含具体文件路径，也可以是判断函数，同 Rule.exclude

例如，想要排除某个文件，可以如下配置要排除的文件具体路径：

const config = {
  rn: {
    compile: {
      exclude: [
        path.resolve(__dirname, '..', 'src/pages/index/vod-wx-sdk-v2.js')
      ]
    }
  }
}

也可以配置判断函数，如下

const config = {
  rn: {
    compile: {
      exclude: [
        function (modulePath) {
          return modulePath.indexOf('vod-wx-sdk-v2') >= 0
        }
      ]
    }
  }
}

rn.compile.include

配置额外需要经过 Taro 编译的文件，例如 Taro 默认不编译 node_modules 包中文件，可以通过这个配置让 Taro 编译 node_modules 包中文件，使用方式与 rn.compile.exclude 一致，同 Rule.include。

rn.webpackChain

自定义 Webpack 配置，接受函数形式的配置。

// 这是一个添加 raw-loader 的例子，用于在项目中直接引用 md 文件
{
  webpackChain (chain, webpack) {
    chain.merge({
      module: {
        rule: {
          myloader: {
            test: /\.md$/,
            use: [{
              loader: 'raw-loader',
              options: {}
            }]
          }
        }
      }
    })
  }
}

// 这是一个添加插件的例子
{
  webpackChain (chain, webpack) {
    chain.merge({
      plugin: {
        install: {
          plugin: require('npm-install-webpack-plugin'),
          args: [{
            // Use --save or --save-dev
            dev: false,
            // Install missing peerDependencies
            peerDependencies: true,
            // Reduce amount of console logging
            quiet: false,
            // npm command used inside company, yarn is not supported yet
            npm: 'cnpm'
          }]
        }
      }
    })
  }
}

注意：第三个参数的取值如下

export enum PARSE_AST_TYPE {
  ENTRY = 'ENTRY',
  PAGE = 'PAGE',
  COMPONENT = 'COMPONENT',
  NORMAL = 'NORMAL',
  STATIC = 'STATIC'
}

rn.cssLoaderOption

css-loader 的附加配置。配置项参考官方文档，例如：

{
  cssLoaderOption: {
    localIdentName: '[hash:base64]'
  }
}

rn.styleLoaderOption

style-loader 的附加配置。配置项参考官方文档，例如：

{
  styleLoaderOption: {
    insertAt: 'top'
  }
}

rn.sassLoaderOption

自 2.2.8 开始，需要安装 @tarojs/plugin-sass 插件才能使用此配置

sass-loader 的附加配置。配置项参考官方文档，例如：

{
  sassLoaderOption: {
    implementation: require("dart-sass")
  }
}

rn.lessLoaderOption

自 2.2.8 开始，需要安装 @tarojs/plugin-less 插件才能使用此配置

less-loader 的附加配置。配置项参考官方文档，例如：

{
  lessLoaderOption: {
    strictMath: true,
    noIeCompat: true
  }
}

rn.stylusLoaderOption

自 2.2.8 开始，需要安装 @tarojs/plugin-stylus 插件才能使用此配置

stylus-loader 的附加配置。配置项参考官方文档。

rn.mediaUrlLoaderOption

针对 mp4 | webm | ogg | mp3 | wav | flac | aac 文件的 url-loader 配置。配置项参考官方文档，例如：

{
  mediaUrlLoaderOption: {
    limit: 8192
  }
}

rn.fontUrlLoaderOption

针对 woff | woff2 | eot | ttf | otf 文件的 url-loader 配置。配置项参考官方文档。

rn.imageUrlLoaderOption

针对 png | jpg | jpeg | gif | bpm | svg 文件的 url-loader 配置。配置项参考官方文档。

rn.miniCssExtractPluginOption

mini-css-extract-plugin 的附加配置，在 enableExtract 为 true 的情况下生效。配置项参考官方文档，例如：

{
  miniCssExtractPluginOption: {
    filename: '[name].css',
    chunkFilename: '[name].css'
  }
}

rn.postcss

配置 postcss 相关插件：

postcss: {
  // 可以进行 autoprefixer 的配置。配置项参考官方文档 https://github.com/postcss/autoprefixer
  autoprefixer: {
    enable: true,
    config: {
      // autoprefixer 配置项
    }
  },
  pxtransform: {
    enable: true,
    config: {
      // pxtransform 配置项，参考尺寸章节
      selectorBlackList: ['body']
    }
  },
  // 小程序端样式引用本地资源内联
  url: {
    enable: true,
    config: {
      limit: 10240 // 设定转换尺寸上限
    }
  },
  // css modules 功能开关与相关配置
  cssModules: {
    enable: false, // 默认为 false，如需使用 css modules 功能，则设为 true
    config: {
      generateScopedName: '[name]__[local]___[hash:base64:5]'
    }
  }
}

designWidth​

sourceRoot​

outputRoot​

plugins​

presets​

babel​

uglify​

terser​

csso​

sass​

单文件路径形式​

多文件路径形式​

指定项目根目录路径形式​

传入 scss 变量字符串​

env​

defineConstants​

alias​

copy​

copy.patterns​

copy.options​

mini​

mini.compile​

mini.compile.exclude​

mini.compile.include​

mini.webpackChain​

mini.commonChunks​

mini.addChunkPages​

mini.cssLoaderOption​

mini.styleLoaderOption​

mini.sassLoaderOption​

mini.lessLoaderOption​

mini.stylusLoaderOption​

mini.mediaUrlLoaderOption​

mini.fontUrlLoaderOption​

mini.imageUrlLoaderOption​

mini.miniCssExtractPluginOption​

mini.postcss​

h5​

h5.devServer​

h5.output​

h5.publicPath​

h5.staticDirectory​

h5.chunkDirectory​

h5.webpackChain​

h5.router​

h5.router.mode​

h5.router.basename​

h5.router.customRoutes​

h5.entry​

h5.enableSourceMap​

h5.sourceMapType​

h5.enableExtract​

h5.esnextModules​

h5.cssLoaderOption​

h5.styleLoaderOption​

h5.sassLoaderOption​

h5.lessLoaderOption​

h5.stylusLoaderOption​

h5.mediaUrlLoaderOption​

h5.fontUrlLoaderOption​

h5.imageUrlLoaderOption​

h5.miniCssExtractPluginOption​

h5.postcss​

h5.postcss.autoprefixer​

h5.postcss.pxtransform​

h5.postcss.cssModules​

rn​

rn.appJSON​

rn.compile​

rn.compile.exclude​

rn.compile.include​

rn.webpackChain​

rn.cssLoaderOption​

rn.styleLoaderOption​

rn.sassLoaderOption​

rn.lessLoaderOption​

rn.stylusLoaderOption​

rn.mediaUrlLoaderOption​

rn.fontUrlLoaderOption​

rn.imageUrlLoaderOption​

designWidth

sourceRoot

outputRoot

plugins

presets

babel

uglify

terser

csso

sass

单文件路径形式

多文件路径形式

指定项目根目录路径形式

传入 scss 变量字符串

env

defineConstants

alias

copy

copy.patterns

copy.options

mini

mini.compile

mini.compile.exclude

mini.compile.include

mini.webpackChain

mini.commonChunks

mini.addChunkPages

mini.cssLoaderOption

mini.styleLoaderOption

mini.sassLoaderOption

mini.lessLoaderOption

mini.stylusLoaderOption

mini.mediaUrlLoaderOption

mini.fontUrlLoaderOption

mini.imageUrlLoaderOption

mini.miniCssExtractPluginOption

mini.postcss

h5

h5.devServer

h5.output

h5.publicPath

h5.staticDirectory

h5.chunkDirectory

h5.webpackChain

h5.router

h5.router.mode

h5.router.basename

h5.router.customRoutes

h5.entry

h5.enableSourceMap

h5.sourceMapType

h5.enableExtract

h5.esnextModules

h5.cssLoaderOption

h5.styleLoaderOption

h5.sassLoaderOption

h5.lessLoaderOption

h5.stylusLoaderOption

h5.mediaUrlLoaderOption

h5.fontUrlLoaderOption

h5.imageUrlLoaderOption

h5.miniCssExtractPluginOption

h5.postcss

h5.postcss.autoprefixer

h5.postcss.pxtransform

h5.postcss.cssModules

rn

rn.appJSON

rn.compile

rn.compile.exclude

rn.compile.include

rn.webpackChain

rn.cssLoaderOption

rn.styleLoaderOption

rn.sassLoaderOption

rn.lessLoaderOption

rn.stylusLoaderOption

rn.mediaUrlLoaderOption

rn.fontUrlLoaderOption

rn.imageUrlLoaderOption