入門

資訊

目前的CRACO版本需要Create React App 5 (react-scripts 5.x.x)。如果使用舊版本的 CRA，請使用適當的 CRACO 版本。

設定 CRACO

1. 從 npm 安裝套件的最新版本作為 dev 相依性

   npm i -D @craco/craco

2. 在專案的根目錄建立 CRACO 組態檔案並設定

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

3. 在package.json的scripts區段中，將對react-scripts的現有呼叫更新為使用cracoCLI

   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"
  }
}