摘要：通過文件可以對圖標名稱等信息進行配置。注意，注冊的只在生產環境中生效，并且該功能只有在下才能有效果該文件是過濾文件配置該文件是描述文件定義了項目所需要的各種模塊，以及項目的配置信息比如名稱版本許可證等元數據。

全局安裝腳手架：

$ npm install -g create-react-app

通過腳手架搭建項目：

$ create-react-app <項目名稱>

開始項目：

$ cd <項目名>
$ npm run start

2.1 package.json 一覽

{
  ......
  "homepage": ".",
  "dependencies": {
    "react": "^16.4.0",
    "react-dom": "^16.4.0",
    "react-scripts": "1.1.4"
  },
  "scripts": {
    "start": "react-scripts start",
    "build": "react-scripts build",
    "test": "react-scripts test --env=jsdom",
    "eject": "react-scripts eject"
  }
}

2.2 可用腳本命令說明：

首先說明：通過npm run 執行下面命令實際上是運行 node_modules/react-srcipt/script下對應的腳本文件；

npm run start : 開始項目，通過http://localhost:3000 可訪問項目；

npm run build : 項目打包，在生產環境中編譯代碼，并放在build目錄中；所有代碼將被正確打包，并進行優化、壓縮同時使用hash重命名文件；執行該命令前需要在package.json中新增條配置"homepage": "."（上面配置文件已給出）, 同時build后的項目需要在服務器下才能訪問；否則打開的將是空白頁面；

npm run test : 交互監視模式下啟動測試運行程序；

npm run eject : 將隱藏的配置導出；需要知道的是create-react-app腳手架本質上是使用react-scripts進行配置項目，所有配置文件信息都被隱藏起來(node_modules/react-scripts)；當需要手動修改擴展webpack配置時有時就需要將隱藏的配置暴露出來；特別需要注意的是該操作是一個單向操作，一旦使用eject，那么就不能恢復了(再次將配置隱藏)；

node_modules : 項目依賴包目錄；

public: 公共目錄，該目錄下的文件都不會被webpack進行加載、解析、打包；通過npm run build進行打包時該項目下的所有文件將會直接被復制到build目錄下；

favicon.ico : 是網站圖標[可替換刪除]

index.html: 頁面模板，webpack打包后將輸出文件引入到該模板內；補充：index.html中通過環境變量%PUBLIC_URL% 來指向public目錄路徑；

manifest.json: PWA將應用添加至桌面的功能的實現依賴于 manifest.json 。通過manifest.json 文件可以對圖標、名稱等信息進行配置。

src: 是源碼目錄該目錄下除了index.js App.test.js registerServiceWorker.js 文件具有一定意義其余文件都是演示使用可直接刪除

index.js: 是整個項目的入口文件；

App.test.js: 測試單元演示文件，暫時并不知道干嘛用；可以直接刪除；

registerServiceWorker.js: service worker 是在后臺運行的一個線程，可以用來處理離線緩存、消息推送、后臺自動更新等任務；registerServiceWorker就是為react項目注冊了一個service worker，用來做資源的緩存，這樣你下次訪問時，就可以更快的獲取資源。而且因為資源被緩存，所以即使在離線的情況下也可以訪問應用（此時使用的資源是之前緩存的資源）。注意，registerServiceWorker注冊的service worker 只在生產環境中生效，并且該功能只有在https下才能有效果；

.gitignore: 該文件是github過濾文件配置

README.md: 該文件是github描述文件

package.json: 定義了項目所需要的各種模塊，以及項目的配置信息（比如名稱、版本、許可證等元數據）。部分依賴模塊被隱藏；

yarn.lock：每次通過yarm添加依賴或者更新包版本時 yarn都會把相關版本信息寫入yarn.lock文件；npm也有類似功能，npm 也可以生成一個鎖文件，就是使用上沒有yarn方便

4.1 方法一：將 webpack 配置暴露出來并進行修改

暴露配置文件：

$ npm run eject
說明: 執行eject腳本后，項目下會新增或對部分配置文件進行修改；項目下 script 目錄存放著腳本文件， config 目錄下存放著配置文件

下載安裝依賴：less-loader less

$ npm install less-loader less -dev

修改 config 目錄下的webpack配置文件：

// 需同時修改下面的兩個文件：
// 開發環境下的配置文件：webpack.config.dev.js 
// 生產環境下的配置文件：webpack.config.prod.js
// 兩個文件的修改內容相同，對應修改內容如下(三處需要進行修改)
......
{
    // 【1】修改文件匹配正則
    test: /.(css|less)$/, 
    use: [
        require.resolve("style-loader"),
        {
            loader: require.resolve("css-loader"),
            options: {
            // 【2】將原本數字 1  改為數字2
            importLoaders: 2,
        },
        },
        { .... },
        // 【3】添加新的加載配置對象
        {
            loader: require.resolve("less-loader"),
        }
    ],
}
......

4.2 方法二：使用 react-app-rewired 對 webpack 進行自定義配置(覆蓋或添加)

安裝依賴包 react-app-rewired：

$ npm install react-app-rewired --save-dev

修改 package.json 中的腳本命令：修改如下

  "scripts": {
    "start": "react-app-rewired start",
    "build": "react-app-rewired build",
    "test": "react-app-rewired test --env=jsdom",
    "eject": "react-app-rewired eject"
  }

在項目根目錄下(和 package.json 同級)新建配置文件 config-overrides.js ，并添加如下內容

module.exports = function override(config, env) {
    // 在這里添加配置
    return config;
}

安裝依賴包 react-app-rewire-less，通過該依賴包來實現對 less 的支持：

$ npm install react-app-rewire-less --save
說明: 這里不再需要額外多帶帶安裝依賴包：less-loader  less

修改 config-overrides.js 配置文件，為 webpack 配置 less

const rewireLess = require("react-app-rewire-less");
module.exports = function override(config, env) {
  // 只需要一條配置信息即可實現對less的支持
  config = rewireLess(config, env);
  // 下面注釋用于配置loader的參數
  // config = rewireLess.withLoaderOptions(someLoaderOptions)(config, env);
  return config;
}

5.1 一般使用方法（不推薦）

搭建項目：

$ create-react-app demo
$ cd demo
$ npm run start

引入 antd 依賴包：

$ npm install npm

引入 antd 組件之前需要先引入 antd 樣式( 在項目入口引入所有樣式 )：

import antd/dist/antd.css

在項目中引入 antd 組件

import { Button } from "antd";

5.2 按需加載

- 上面引入組件和樣式的方式，會一次性加載所有樣式并引入組件中的所有相應模塊；
- 這種引入方式將會影響到應用的網絡性能；
- 相應的就需要改變引入組件和樣式的方式，實現樣式和組件的按需加載；
- 下面將介紹三種按需加載組件樣式的方法：

5.2.1 方法一: 精確加載組件

import Button from "antd/lib/button";
import "antd/lib/button/style"; 
// 或者通過import antd/lib/button/style/css 進行加載樣式

5.2.2 方法二：通過暴露配置 配合 babel-plugin-import插件實現按需加載
babel-plugin-import 是一個用于按需加載組件代碼和樣式的 babel 插件

暴露配置

$ npm run eject

安裝插件：

$ npm install babel-plugin-import --save-dev

修改 package.json

"babel": {
  "presets": [
    "react-app"
  ],
  "plugins": [
    ["import", { "libraryName": "antd", "libraryDirectory": "es", "style": "css" }]
  ]
},

配置完后可直接導入 antd 的組件，不再需要另外引入css樣式；

import { Button } from "antd";9

5.2.2 方法三：通過 babel-plugin-import + react-app-rewired實現按需加載（官網推薦）

react-app-rewired：的使用上文有過描述；主要用于在不暴露配置的情況下對webpack的配置進行擴展；

babel-plugin-import 是一個用于按需加載組件代碼和樣式的 babel 插件

安裝依賴包：babel-plugin-import

$ npm install babel-plugin-import --save-dev

通過 react-app-rewired 對 webpack 配置進行擴展添加新的babel插件，config-overrides.js 修改 ( 添加 ) 如下內容：

// 引入 react-app-rewired 添加 babel 插件的函數
const { injectBabelPlugin } = require("react-app-rewired");
module.exports = function override(config, env) {
    config = injectBabelPlugin(["import", 
        { libraryName: "antd", libraryDirectory: "es", style: "css" }], config);
    return config;
};

配置完后可直接導入 antd 的組件，不再需要另外引入css樣式；

import { Button } from "antd";9

5.3 通過 react-app-rewired 擴展 webpack 來實現 antd 自定義主題

主要通過利用了 less-loader 的 modifyVars 參數來進行主題配置

安裝配置：react-app-rewired (上文已經詳細介紹過這里就不再細說)

安裝依賴包 react-app-rewire-less ：實現對 less 的支持同時添加 modifyVars 加載參數設置

 $ npm react-app-rewire-less --save-dev 

修改 config-overrides.js 配置文件

const rewireLess = require("react-app-rewire-less");
const { injectBabelPlugin } = require("react-app-rewired");
module.exports = function override(config, env) {
    // 擴展 webpack ==> 支持less
    config = rewireLess(config, env);
    // 配置loader參數
    config = rewireLess.withLoaderOptions({
        // 修改默認顏色 實現自定義主題
        modifyVars: { "@primary-color": "#1DA57A" },
   })(config, env);
   // antd 按需加載配置
    config = injectBabelPlugin(["import", 
        { libraryName: "antd", libraryDirectory: "es", style: true }], config);
    return config;
}

5.4 通過插件 babel-plugin-transform-decorators-legacy 實現對修飾器的支持

5.4.1 通過暴露配置實現

暴露配置

$ npm run eject

安裝插件：

$ npm install --save-dev babel-plugin-transform-decorators-legacy

修改 package.json

"babel": {
  "presets": [
    "react-app"
  ],
  "plugins": [
    ["transform-decorators-legacy"]
  ]
},

5.4.2 使用插件 react-app-rewired 對配置進行擴展實現對修飾器的支持

react-app-rewired 的使用詳見上文：

安裝插件：

$ npm install --save-dev babel-plugin-transform-decorators-legacy

編寫 config-overrides.js 配置文件

// 導入添加babel插件的函數
const { injectBabelPlugin } = require("react-app-rewired");
module.exports = function override(config, env) {
  // do stuff with the webpack config...
  // 修飾器擴展 (添加babel插件：transform-decorators-legacy ）
  config = injectBabelPlugin("transform-decorators-legacy", config)
  return config;
};

6.1 通過 react-app-rewired 進行擴展配置時 發現啟動項目后并沒有效果？

在確保一起配置沒有問題下：

請確認是否有對腳本命令進行了正確的修改，使用react-app-rewired 擴展配置需要修改腳本命令

{
  ....
  "scripts": {
    "start": "react-app-rewired start",
    "build": "react-app-rewired build",
    "test": "react-app-rewired test --env=jsdom",
    "eject": "react-app-rewired eject"
  },
...
}