Antd create-react-app 按需加载无效解决方案（亲测可行）

最新推荐文章于 2024-09-13 22:48:39 发布

原创最新推荐文章于 2024-09-13 22:48:39 发布 · 609 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#react #webpack #reactjs #前端

性能优化专栏收录该内容

1 篇文章

订阅专栏

本文介绍了在使用create-react-app搭建的React应用中，遇到Antd按需加载无效的问题及其解决方案。根据Antd官方指南，通过安装插件、修改package.json和config-overrides.js进行配置，但初次尝试导致样式丢失。为了解决这个问题，开发者执行了`npm run eject`以获取webpack配置，并在webpack.config.js中调整babelrc为true，同时在`babel-loader`的plugins中添加相应设置，最终成功实现Antd按需加载。优化后，首屏加载效率显著提升。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

Antd 版本为V3

首先按antd 官方网址提供的方法，安装插件
官方地址：https://3x.ant.design/docs/react/use-with-create-react-app-cn

npm i react-app-rewired customize-cra --save
修改package.json

 /* package.json */
"scripts": {
-   "start": "react-scripts start",
+   "start": "react-app-rewired start",
-   "build": "react-scripts build",
+   "build": "react-app-rewired build",
-   "test": "react-scripts test",
+   "test": "react-app-rewired test",
}

在项目根目录创建一个 config-overrides.js ，新增配置如下

const { override, fixBabelImports } = require('customize-cra');
module.exports = override(
    fixBabelImports('import', {
        libraryName: 'antd',
        libraryDirectory: 'es',
        style: 'css',
    }),
);

npm i babel-plugin-import --save
移除 src/App.css 里全量添加的 @import ‘~antd/dist/antd.css’;
在文件内引用如下

  // src/App.js
  import React, { Component } from 'react';
- import Button from 'antd/es/button';
+ import { Button } from 'antd';
  import './App.css';

  class App extends Component {
    render() {
      return (
        <div className="App">
          <Button type="primary">Button</Button>
        </div>
      );
    }
  }

  export default App;

按照官方引导，这样完成之后，重新启动项目，我的文件样式丢失。

将所有代码commit 后，使用 npm run eject ，暴露webpack.config.js文件，会有提示信息“复制所有依赖文件和相应的依赖到项目中”，确认就好。会出现config和script文件
在 webpack.config.js 做修改，搜索“babelrc”, 将值改为true
在‘babel-loader’ 的 plugins 中写入

[
                    'import',
                    {libraryName:"antd", style:'css'}
                  ],

效果图如下：
在这里插入图片描述
这样页面就有样式了~

同理，按需加载确实提升了首屏加载的效率，以下是对比图：
优化前：

优化后：