create-react-app搭建react項(xiàng)目

我的電腦是Windows10系統(tǒng)唧瘾,在使用react之前需安裝node.js,在node.js中自帶npm,另外還需要安裝yarn,version:1.5.1

react腳手架create-react-app中文文檔地址:
[Create React App]: https://www.css88.com/create-react-app/docs/documentation-intro/

1. 搭建自己的react項(xiàng)目

  1. 打開(kāi)WebStorm,在底部點(diǎn)擊進(jìn)入Terinal俱诸,使用cd命令進(jìn)入自己保存項(xiàng)目的位置粱坤。以下所有命令都是在該處(my-app目錄下)進(jìn)行
  2. 輸入:yarn create-react-app my-app 其中my-app為項(xiàng)目名稱(chēng)
  3. 輸入:yarn install
  4. 輸入:yarn start ,啟動(dòng)項(xiàng)目
  5. 瀏覽器地址欄輸入:localhost:3000即可打開(kāi)react項(xiàng)目
  6. 要停止項(xiàng)目尚揣,按下Ctrl + c ,輸入Y即可

2.修改項(xiàng)目默認(rèn)端口號(hào)3000

  1. 進(jìn)入node-modules--react-scripts -- scripts -- start.js修改端口號(hào)
  2. 如下圖掖举,修改3000為你想要設(shè)置的端口號(hào)
  3. ? 有圖

3.自動(dòng)生成的項(xiàng)目目錄以及文件解析

  1. node_modules: 項(xiàng)目依賴(lài)包目錄快骗;
  2. public: 公共目錄,該目錄下的文件都不會(huì)被webpack進(jìn)行加載塔次、解析方篮、打包;通過(guò)yarn build進(jìn)行打包時(shí)該項(xiàng)目下的所有文件將會(huì)直接被復(fù)制到build目錄下励负;
    1. favicon.ico: 是網(wǎng)站圖標(biāo)[可替換刪除]
    2. index.html: 頁(yè)面模板藕溅,webpack打包后將輸出文件引入到該模板內(nèi);補(bǔ)充:index.html中通過(guò)環(huán)境變量%PUBLIC_URL% 來(lái)指向public目錄路徑继榆;
    3. manifest.json: PWA將應(yīng)用添加至桌面的功能的實(shí)現(xiàn)依賴(lài)于 manifest.json 巾表。通過(guò)manifest.json文件可以對(duì)圖標(biāo)、名稱(chēng)等信息進(jìn)行配置略吨。
  3. src: 是源碼目錄該目錄下除了index.js App.test.js registerServiceWorker.js文件具有一定意義其余文件都是演示使用可直接刪除
    1. index.js: 是整個(gè)項(xiàng)目的入口文件集币;
    2. App.test.js: 測(cè)試單元演示文件,暫時(shí)并不知道干嘛用翠忠;可以直接刪除鞠苟;
    3. registerServiceWorker.js: service worker是在后臺(tái)運(yùn)行的一個(gè)線(xiàn)程,可以用來(lái)處理離線(xiàn)緩存秽之、消息推送当娱、后臺(tái)自動(dòng)更新等任務(wù);registerServiceWorker就是為react項(xiàng)目注冊(cè)了一個(gè)service worker考榨,用來(lái)做資源的緩存跨细,這樣你下次訪(fǎng)問(wèn)時(shí),就可以更快的獲取資源河质。而且因?yàn)橘Y源被緩存扼鞋,所以即使在離線(xiàn)的情況下也可以訪(fǎng)問(wèn)應(yīng)用(此時(shí)使用的資源是之前緩存的資源)。注意愤诱,registerServiceWorker注冊(cè)的service worker只在生產(chǎn)環(huán)境中生效云头,并且該功能只有在https下才能有效果;
  4. gitignore: 該文件是github過(guò)濾文件配置
  5. README.md: 該文件是github描述文件
  6. package.json: 定義了項(xiàng)目所需要的各種模塊淫半,以及項(xiàng)目的配置信息(比如名稱(chēng)溃槐、版本、許可證等元數(shù)據(jù))科吭。部分依賴(lài)模塊被隱藏昏滴;
  7. yarn.lock:每次通過(guò)yarm添加依賴(lài)或者更新包版本時(shí) yarn都會(huì)把相關(guān)版本信息寫(xiě)入yarn.lock文件猴鲫;npm也有類(lèi)似功能,npm 也可以生成一個(gè)鎖文件谣殊,就是使用上沒(méi)有yarn方便

4.擴(kuò)展webpack配置

使用 react-app-rewired 對(duì) webpack 進(jìn)行自定義配置

  1. 安裝依賴(lài)包 react-app-rewiredyarn add react-app-rewired --save-dev

  2. 修改 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"
      }
    
  3. 在項(xiàng)目根目錄下(和package.json同級(jí))新建配置文件 config-overrides.js燥狰,并添加如下內(nèi)容

    module.exports = function override(config, env) {
        // 在這里添加配置
        return config;
    }
    
  4. 安裝依賴(lài)包react-app-rewire-less世分,通過(guò)該依賴(lài)包來(lái)實(shí)現(xiàn)對(duì)less的支持

    yarn add react-app-rewired@1.5.0

  5. 修改 config-overrides.js 配置文件焕襟,為 webpack配置 less

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

在 create-react-app 中使用Antd

  1. 通過(guò)babel-plugin-import + react-app-rewired實(shí)現(xiàn)按需加載(官網(wǎng)推薦)

    1. react-app-rewired:的使用上文有過(guò)描述朱监;主要用于在不暴露配置的情況下對(duì)webpack的配置進(jìn)行擴(kuò)展;
    2. babel-plugin-import 是一個(gè)用于按需加載組件代碼和樣式的babel插件
    • 安裝依賴(lài)包:babel-plugin-import
     yarn add babel-plugin-import --save-dev
    
    • 通過(guò) react-app-rewired 對(duì)webpack 配置進(jìn)行擴(kuò)展添加新的babel插件蛇捌,config-overrides.js 修改 ( 添加 ) 如下內(nèi)容:
    // 引入 react-app-rewired 添加 babel 插件的函數(shù)
    const { injectBabelPlugin } = require('react-app-rewired');
    module.exports = function override(config, env) {
        config = injectBabelPlugin(['import', 
            { libraryName: 'antd', libraryDirectory: 'es', style: 'css' }], config);
        return config;
    };
    
    • 配置完后可直接導(dǎo)入antd的組件抚恒,不再需要另外引入css樣式;
    import { Button } from 'antd';
    
  2. 通過(guò) react-app-rewired 擴(kuò)展 webpack 來(lái)實(shí)現(xiàn) antd 自定義主題
    主要通過(guò)利用了 less-loadermodifyVars參數(shù)來(lái)進(jìn)行主題配置

    • 安裝配置:react-app-rewired(上文已經(jīng)詳細(xì)介紹過(guò)這里就不再細(xì)說(shuō))
    • 安裝依賴(lài)包react-app-rewire-less:實(shí)現(xiàn)對(duì) less 的支持同時(shí)添加 modifyVars 加載參數(shù)設(shè)置
yarn add 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) {
    // 擴(kuò)展 webpack ==> 支持less
    config = rewireLess(config, env);
    // 配置loader參數(shù)
    config = rewireLess.withLoaderOptions({
        // 修改默認(rèn)顏色 實(shí)現(xiàn)自定義主題
        modifyVars: { "@primary-color": "#1DA57A" },
   })(config, env);
   // antd 按需加載配置
    config = injectBabelPlugin(['import', 
        { libraryName: 'antd', libraryDirectory: 'es', style: true }], config);
    return config;
}

版本兼容問(wèn)題:因?yàn)榘姹締?wèn)題導(dǎo)致的啟動(dòng)錯(cuò)誤络拌,這里提供一套正常兼容的基本版本俭驮。安裝的時(shí)候帶上版本號(hào)即可

yarn add package-name@1.2.3

package.json

{
  "name": "icarus-ui",
  "version": "0.1.0",
  "private": true,
  "dependencies": {
    "babel-plugin-import": "^1.4.0",
    "babel-plugin-transform-decorators-legacy": "1.3.4",
    "react": "^16.7.0",
    "react-app-rewire-less": "^2.1.0",
    "react-app-rewired": "1.5.0",
    "react-dom": "^16.7.0",
    "react-scripts": "1.0.12"
  },
  "scripts": {
    "start": "react-app-rewired start",
    "build": "react-app-rewired build",
    "test": "react-app-rewired test --env=jsdom",
    "eject": "react-app-rewired eject"
  },
  "eslintConfig": {
    "extends": "react-app"
  },
  "browserslist": [
    ">0.2%",
    "not dead",
    "not ie <= 11",
    "not op_mini all"
  ]
}

參考:https://segmentfault.com/a/1190000015301231

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個(gè)濱河市春贸,隨后出現(xiàn)的幾起案子混萝,更是在濱河造成了極大的恐慌,老刑警劉巖萍恕,帶你破解...
    沈念sama閱讀 206,839評(píng)論 6 482
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件譬圣,死亡現(xiàn)場(chǎng)離奇詭異,居然都是意外死亡雄坪,警方通過(guò)查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 88,543評(píng)論 2 382
  • 文/潘曉璐 我一進(jìn)店門(mén)屯蹦,熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái)维哈,“玉大人,你說(shuō)我怎么就攤上這事登澜±樱” “怎么了?”我有些...
    開(kāi)封第一講書(shū)人閱讀 153,116評(píng)論 0 344
  • 文/不壞的土叔 我叫張陵脑蠕,是天一觀(guān)的道長(zhǎng)购撼。 經(jīng)常有香客問(wèn)我,道長(zhǎng)谴仙,這世上最難降的妖魔是什么迂求? 我笑而不...
    開(kāi)封第一講書(shū)人閱讀 55,371評(píng)論 1 279
  • 正文 為了忘掉前任,我火速辦了婚禮晃跺,結(jié)果婚禮上揩局,老公的妹妹穿的比我還像新娘。我一直安慰自己掀虎,他們只是感情好凌盯,可當(dāng)我...
    茶點(diǎn)故事閱讀 64,384評(píng)論 5 374
  • 文/花漫 我一把揭開(kāi)白布付枫。 她就那樣靜靜地躺著,像睡著了一般驰怎。 火紅的嫁衣襯著肌膚如雪阐滩。 梳的紋絲不亂的頭發(fā)上,一...
    開(kāi)封第一講書(shū)人閱讀 49,111評(píng)論 1 285
  • 那天县忌,我揣著相機(jī)與錄音掂榔,去河邊找鬼。 笑死芹枷,一個(gè)胖子當(dāng)著我的面吹牛衅疙,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播鸳慈,決...
    沈念sama閱讀 38,416評(píng)論 3 400
  • 文/蒼蘭香墨 我猛地睜開(kāi)眼饱溢,長(zhǎng)吁一口氣:“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼!你這毒婦竟也來(lái)了走芋?” 一聲冷哼從身側(cè)響起绩郎,我...
    開(kāi)封第一講書(shū)人閱讀 37,053評(píng)論 0 259
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤,失蹤者是張志新(化名)和其女友劉穎翁逞,沒(méi)想到半個(gè)月后肋杖,有當(dāng)?shù)厝嗽跇?shù)林里發(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 43,558評(píng)論 1 300
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡挖函,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 36,007評(píng)論 2 325
  • 正文 我和宋清朗相戀三年状植,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片怨喘。...
    茶點(diǎn)故事閱讀 38,117評(píng)論 1 334
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡津畸,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出必怜,到底是詐尸還是另有隱情肉拓,我是刑警寧澤,帶...
    沈念sama閱讀 33,756評(píng)論 4 324
  • 正文 年R本政府宣布梳庆,位于F島的核電站暖途,受9級(jí)特大地震影響,放射性物質(zhì)發(fā)生泄漏膏执。R本人自食惡果不足惜驻售,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 39,324評(píng)論 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望更米。 院中可真熱鬧芋浮,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開(kāi)封第一講書(shū)人閱讀 30,315評(píng)論 0 19
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)。三九已至瘤旨,卻和暖如春梯啤,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背存哲。 一陣腳步聲響...
    開(kāi)封第一講書(shū)人閱讀 31,539評(píng)論 1 262
  • 我被黑心中介騙來(lái)泰國(guó)打工因宇, 沒(méi)想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人祟偷。 一個(gè)月前我還...
    沈念sama閱讀 45,578評(píng)論 2 355
  • 正文 我出身青樓察滑,卻偏偏與公主長(zhǎng)得像,于是被迫代替她去往敵國(guó)和親修肠。 傳聞我的和親對(duì)象是個(gè)殘疾皇子贺辰,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 42,877評(píng)論 2 345