react-scripts 已经很久不维护，相关依赖库没有及时更新，扩展配置也麻烦，官方推荐使用 Next.js 或 Remix，但对于 传统 CSR 渲染模式的 React Web App 项目，简单清晰的 react-scripts 仍是首选，该项目 fork 自 react-scripts，使用 TypeScript + Pure ESM 进行改写，添加一些功能和优化，同时引入 rsbuild，支持 webpack && rsbuild 双构建引擎切换

特性

• 支持 webpack && rsbuild 双构建引擎切换
• webpack 配置基于 [email protected] ，使用 TypeScript + Pure ESM 进行改写，添加一些功能和优化
• rsbuild 配置对标内部 webpack 配置，适用项目快速开发
• 支持 type:modules ESM 模式开发项目
• 类似 craco，可通过配置文件对该构建工具进行扩展配置
• webpack、rsbuild 以及周边 loader、plugin 等相关依赖包保持及时的更新
• webpack配置增加 esbuild 和 swc 支持，可切换 对应的 js/css minify 压缩器，提高构建速度
• 内置 less、scss、sass、stylus CSS 预处理器
• 内置 babel-plugin-jsx-css-modules 插件，就像写普通 css 样式一样写 css module 模块化代码
• 内置 webpack-bundle-analyzer 打包分析插件
• 内置 svg-sprite-loader svg 精灵图优化 loader
• 增加 eslint-webpack-plugin 和 stylelint-webpack-plugin，默认读取业务项目目录的配置
• 可在开发环境下自动获取局域网 IP 并映射到地址栏，便于本地联调

安装

pnpm add @mango-scripts/react-scripts -D

注意：这是一个 纯ESM包

使用

脚本命令

安装该库之后，你可以在 npm scripts 中以 react-scripts 或者从终端中以 ./node_modules/.bin/react-scripts 访问这个命令。

推荐 npm scripts 如下：

选择 webpack 构建

"scripts": {
  "dev": "react-scripts dev --mode development",
  "build:dev": "react-scripts build --mode dev",
  "build:test": "react-scripts build --mode test",
  "build:stage": "react-scripts build --mode stage",
  "build:prod": "react-scripts build --mode prod",
},

选择 rsbuild 构建

"scripts": {
  "dev": "react-scripts dev --mode development --bundler rsbuild",
  "build:dev": "react-scripts build --mode dev --bundler rsbuild",
  "build:test": "react-scripts build --mode test --bundler rsbuild",
  "build:stage": "react-scripts build --mode stage --bundler rsbuild",
  "build:prod": "react-scripts build --mode prod --bundler rsbuild",
},

模式和环境变量

与vue-cli类似，@mango-scripts/react-scripts 支持模式和环境变量。

一般来说，一个项目有两个主要模式：

• development 模式：用于本地开发环境
• production 模式：用于线上环境

日常实际项目开发中，对于线上环境，往往需要区分开发 / 测试 / 预发布 / 正式，可通过不同模式进行区分。默认线上环境模式如下：

• dev 模式：用于线上开发环境
• test 模式：用于线上测试环境
• stage 模式：用于线上预发布环境
• prod 模式：用于线上正式环境

通过传递 --mode 模式选项，你可以加载对应的环境变量文件

例如：

1. 当运行 react-scripts dev 命令时，将依次读取并加载项目根目录下 .env、.env.development、 .env.development.local 的环境变量信息，后者同名变量会覆盖前者；

2. 当运行 react-scripts build --mode stage 命令时，将依次读取并加载项目根目录下 .env、.env.production、 .env.stage、.env.stage.local 的环境变量信息，后者同名变量会覆盖前者

扩展配置

项目根目录下新增 mango.config.mjs 配置文件

mango.config.mjs：

1. 选择基于 webpack 构建时，配置选项如下：

import { defineConfig } from '@mango-scripts/react-scripts'

export default defineConfig({
  distDir: 'build',
  loader: {
    babel: {
      enable: true,
      options: {
        plugins: [
          [
            require.resolve('@babel/plugin-proposal-decorators'),
            {
              legacy: true,
            },
          ],
        ],
      },
    },
    less: {
      enable: true,
      options: {
        lessOptions: {
          modifyVars: {
            'brand-primary': '#975ec9',
            'brand-primary-tap': '#7e3db7',
            'switch-fill': '#975ec9',
          },
        },
      },
    },
    sass: {
      enable: true,
      options: {
        additionalData: `@import "src/styles/mixins.scss";`,
      },
    },
    stylus: {
      enable: true,
      options: {},
    },
    postcss: {
      enable: true,
      options: {},
    },
    swc: {
      enable: false,
      options: {},
    },
    esbuild: {
      enable: false,
      options: {},
    },
  },
  plugin: {
    eslint: {
      enable: true,
      options: {},
    },
    stylelint: {
      enable: true,
      options: {},
    },
    typescript: {
      enable: true,
      options: {},
    },
  },
  optimization: {
    splitChunks: {},
    minimizer: {
      jsMinimizer: {
        minify: 'terserMinify', // terserMinify | uglifyJsMinify | esbuildMinify | swcMinify
        terserOptions: {
          compress: {
            drop_console: true,
            drop_debugger: true,
          },
        },
      },
      cssMinimizer: {
        minify: 'cssnanoMinify', // cssnanoMinify | cssoMinify | cleanCssMinify | esbuildMinify  | lightningCssMinify | swcMinify
        minimizerOptions: {},
      },
    },
  },
})

2. 选择基于 rsbuild 构建时，配置选项如下：

import { defineConfig } from '@mango-scripts/react-scripts'

export default defineConfig({
  // 具体配置参考rsbuild配置文档：https://rsbuild.dev/config/index
  tools: {
    sass: {
      additionalData: `@import "src/styles/mixins.scss";`,
    },
  },
  ...
})

License

MIT