入门

信息

当前的 **CRACO** 版本需要 **Create React App 5** (react-scripts 5.x.x)。如果使用更早版本的 CRA， 使用相对应的 CRACO 版本。

设置 CRACO

1. 从 npm 安装最新版本的软件包作为开发依赖项

   npm i -D @craco/craco

2. 在项目根目录创建一个 CRACO 配置文件并在 配置

     my-app
     ├── node_modules
   + ├── craco.config.js
     └── package.json

3. 将现有对 react-scripts 的调用更新为在 package.json 的 scripts 部分中使用 craco CLI

   package.json

   "scripts": {
   -  "start": "react-scripts start"
   +  "start": "craco start"
   -  "build": "react-scripts build"
   +  "build": "craco build"
   -  "test": "react-scripts test"
   +  "test": "craco test"
   }

你现在可以照常启动或构建你的应用

npm start

npm run build

开始配置

查看 配置文档。

TypeScript 支持

CRACO 提供官方类型，如果希望在你的配置文件中进行类型检查和 IDE 自动补全，你可以使用这些类型

npm i -D @craco/types

向后兼容性

CRACO 并不是为了向后兼容与旧版本的 Create React App，并且仅支持最新版本。如果你的项目使用旧版本（可以通过项目中 react-scripts 依赖项的版本来确定），请参阅下表来选择合适的 CRACO 版本。

react-scripts 版本	CRACO 版本
5.x.x（最新）	7.0.0
4.x.x	6.4.5
< 4.0.0	5.8.0

调试

详细的日志记录

要激活详细的日志记录，请指定 CLI 选项 --verbose

package.json

{
  "scripts": {
    "start": "craco start --verbose"
  }
}