react build配置插件customize-cra介绍

直入主题

customize-cra源码地址
献上api文档

Overview

customize-cra takes advantage of react-app-rewired's config-overrides.js file. By importing customize-cra functions and exporting a few function calls wrapped in our override function, you can easily modify the underlying config objects (webpack, webpack-dev-server, babel, etc.) that make up create-react-app.
翻译:customize-cra利用react-app-rewired的config-overrides.js文件。通过导入customize-cra函数并导出覆盖函数中包含的几个函数调用,您可以轻松修改组成create-react-app的底层配置对象(webpack、webpack-dev-server、babel等)。

说人话

上面都是抄的,说人话就是config-overrides.js文件能在不暴露webpack文件时修改打包的配置对象,搞起来。
感觉自己行了的,可以直接去看api文档,照猫画虎。
下面是我的配置代码

// config-overrides.js
/* eslint-disable no-useless-computed-key */
const {
  override,
  addWebpackAlias,
  addWebpackResolve,
  fixBabelImports,
  addLessLoader,
  adjustStyleLoaders,
  addWebpackPlugin,
  addWebpackModuleRule,
} = require('customize-cra');
const UglifyJsPlugin = require('uglifyjs-webpack-plugin'); // 代码压缩
const { BundleAnalyzerPlugin } = require('webpack-bundle-analyzer'); // 大文件定位
const ProgressBarPlugin = require('progress-bar-webpack-plugin'); // 打包进度
const CompressionPlugin = require('compression-webpack-plugin'); // gzip压缩
const MiniCssExtractPlugin = require('mini-css-extract-plugin'); // css压缩
const path = require('path');

module.exports = override(
  // 导入文件的时候可以不用添加文件的后缀名
  addWebpackResolve({
    extensions: ['.tsx', '.ts', '.js', '.jsx', '.json'],
  }),
  // 路径别名
  addWebpackAlias({
    ['@']: path.resolve(__dirname, 'src'),
  }),
  // less预加载器配置
  addLessLoader({
    strictMath: true,
    noIeCompat: true,
    modifyVars: {
      '@primary-color': '#1DA57A', // for example, you use Ant Design to change theme color.
    },
    cssLoaderOptions: {}, // .less file used css-loader option, not all CSS file.
    cssModules: {
      localIdentName: '[path][name]__[local]--[hash:base64:5]', // if you use CSS Modules, and custom `localIdentName`, default is '[local]--[hash:base64:5]'.
    },
  }),
  // 注意是production环境启动该plugin
  process.env.NODE_ENV === 'production' &&
    addWebpackPlugin(
      new UglifyJsPlugin({
        // 开启打包缓存
        cache: true,
        // 开启多线程打包
        parallel: true,
        uglifyOptions: {
          // 删除警告
          warnings: false,
          // 压缩
          compress: {
            // 移除console
            drop_console: true,
            // 移除debugger
            drop_debugger: true,
          },
        },
      })
    ),
  addWebpackPlugin(new MiniCssExtractPlugin()),
  // 判断环境变量ANALYZER参数的值
  process.env.ANALYZER && addWebpackPlugin(new BundleAnalyzerPlugin()),
  // 打包进度条
  addWebpackPlugin(new ProgressBarPlugin()),
  // 需要nginx配合
  // addWebpackPlugin(
  //   new CompressionPlugin({
  //     filename: '[path][base].gz',
  //     algorithm: 'gzip',
  //     test: /\.js$|\.html$|\.css/,
  //     threshold: 10240, // 只有大小大于该值的资源会被处理 10240字节
  //     minRatio: 1, // 只有压缩率小于这个值的资源才会被处理
  //     deleteOriginalAssets: false, // 删除原文件
  //   })
  // )
  addWebpackModuleRule({
    test: [/\.bmp$/, /\.gif$/, /\.jpe?g$/, /\.png$/],
    loader: require.resolve('url-loader'),
    options: {
      limit: 64,
      name: 'static/media/[name].[hash:8].[ext]',
    },
  })
  addWebpackModuleRule({
    test: [/\.css$/, /\.less$/], // 可以打包后缀为sass/scss/css的文件
    use: ['style-loader', 'css-loader', 'less-loader'],
  })
);

说几个常用的配置

  1. addWebpackAlias 相当于 webpack的Plugin
  2. addWebpackModuleRule 相当于webpack里Module的rules
  3. addWebpackAlias 相当于 webpack里resolve的alias,添加路径别名
  4. addWebpackExternals 相当于 webpack里Externals,添加外部扩展CDN

其他的大火自己去看,简单的一些配置=》好使

最后加点水,我的爬坑之路,我是怎么一步步被迫学习这些配置的,看看你们有没有遇到过相同的报错

爬坑之路

我写的烂代码出了一个bug,我删除node_modules重新下载希望能解决bug①,但是失败了结果又产生了build失败(报错①如下图)的新bug②(强行混工时)!看了很多百度上cv的水文没解决,最后自己从webpack到customize-cra再到config-overrides.js配置,最终花了大半天解决了。所以记录下自己的解决过程看看能不能帮到大火。

报错截图 Error: You forgot to add 'mini-css-extract-plugin' plugin (i.e. `{ plugins: [new MiniCssExtractPlugin()] }`)

查了下要配置webpack.config.js,但我项目里没有配置webpack的config文件夹。
有人会问为啥不“npm run eject”暴露出来,答案就是我不想呀,多那么多文件看起来头疼。create-react-app创建react项目的时候包含的customize-cra插件里提供的config-overrides.js文件能帮我们覆盖webpack里的一些配置,完全够用了。
我按着customize-cra的api说明,加了条 addWebpackPlugin(new MiniCssExtractPlugin())

原先的报错是没了,出来个新的错误②:TypeError: value.split is not a function

TypeError: value.split is not a function

看不懂了,这提示的好简单呀,但是我看里头有css字样,应该是样式打包的问题,我就加了点rule

addWebpackModuleRule({
    test: [/\.css$/], // 可以打包后缀为sass/scss/css的文件
    use: ['style-loader', 'css-loader'],
  })

还有错,百度后感觉少了个less,就再加了点

addWebpackModuleRule({
    test: [/\.css$/, /\.less$/], // 可以打包后缀为sass/scss/css的文件
    use: ['style-loader', 'css-loader'],
  })

错误变了:CssSyntax error: Unknown word (14:3)

CssSyntax error: Unknown word (14:3)

我一想是不是确实less的加载器,又改了下

addWebpackModuleRule({
    test: [/\.css$/, /\.less$/], // 可以打包后缀为sass/scss/css的文件
    use: ['style-loader', 'css-loader', 'less-loader'],
})

这回成了!!菜菜的我在疯狂尝试中解决了这个bug
文档看着就是香,比花时间一个个点百度上那些水文肯定有效率!当然前提是你问题定位是对的,不然还是得挨个试错

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,362评论 5 477
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,330评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,247评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,560评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,580评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,569评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,929评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,587评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,840评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,596评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,678评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,366评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,945评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,929评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,165评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 43,271评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,403评论 2 342

推荐阅读更多精彩内容