深度解析React以create-react-app爲基礎創建項目

這篇文章主要介紹了react以create-react-app爲基礎創建項目,寫的十分的全面細緻,具有一定的參考價值,對此有需要的朋友可以參考學習下。如有不足之處,歡迎批評指正。

什麼是create-react-app

create-react-app是一個js庫,使用它能夠很方便地建立react項目,免去了建立react項目時配置webpack、調試服務器、運行腳本等麻煩,你只需要使用這個庫,便可以一鍵完成react項目的創建初始化項目

注:用“[ ]”包裹的都是可自定義的內容,例如:cd [project-name],實際上可能是cd my-app,也可能是cd my-project。總之“[ ]”包裹的內容,只表示上下文裏相互對應的變量。

npm install -g create-react-app 
  
create-react-app [project-name] 
cd [project-name]

運行完以上命令就已經處在新建的項目中了,此時運行npm run start和npm run build了。但是,默認所有配置是隱藏起來的,要想自定義配置,需要運行一個命令:

npm run eject

此時會提示,該命令不可逆,是否繼續,輸入y,這樣所有配置項就都出來了。這時候也可以做一些定製化的配置了,比如:

修改build後的output位置

js / css / img等靜態資源會默認輸出到 build -> static 下面,其配置項在config -> webpack.config.prod.js 裏。

  1. js在output屬性裏,大約第60行 ;
  2. css在開頭的cssFilename變量聲明,大約第38行;
  3. 圖片等在module -> rules的loader配置裏,大約第143行;

map文件由devtool屬性控制,如果不想要map,註釋掉就可以,大約第57行;

manifest.json在ManifestPlugin的配置裏,大約294行;

基礎模板在HtmlWebpackPlugin的配置裏,不過可以看到,是引的 ‘./paths.js' 文件,所以要修改 config -> paths.js 裏面的 appHtml 屬性;

默認在build時會清空build目錄,配置項是scripts -> build.js 裏的 fs.emptyDirSync(paths.appBuild); 這一句,註釋掉就不會把老文件刪掉了(灰度發佈的時候可能會用到);

不eject其他修改配置的方法

除了 npm run eject 暴露出所有配置文件外,還有其他辦法修改配置,由於本文主題原因不做展開,僅給出相關鏈。

一個(部分人認爲)比較優雅的方法,即引入 react-app-rewired 插件來實現配置覆蓋。需要在根目錄新建一個 config-overrides.js 文件,想配置啥就寫啥(怎麼又多出來一種配置。。。),還需要重寫下npm start等相關命令,詳情點擊鏈接查看。

另一個可參考create-react-app的git主頁上推薦的Adding a CSS Preprocessor (Sass, Less etc.) 例子。大概思路就是先安裝一個node環境可編譯sass的插件node-sass-chokidar,然後利用npm-run-all同時運行npm start 和 watch-css(監聽sass文件的命令)。個人感覺繞了個大圈,還是再議吧。。。

react等作爲全局變量不打包

爲了利用cdn,我們常會在頁面裏引用react或其他類似庫的script標籤,這樣在瀏覽器環境裏就有了相應的全局變量,同時減少了js的體積。下面以react爲例。

首先在config -> webpack.config.prod.js 的配置里加入如下代碼:

module.exports = { 
 ... 
 externals: { 
 'react': 'React', 
 'react-dom': 'ReactDOM'
 }, //歡迎加入前端全棧開發交流圈一起吹水聊天學習交流:864305860
 ... 
} 

ey對應的是庫的名字,value對應的是全局變量的名字。這裏要注意,全局變量的名字要與代碼中import的名字一致,要保證規範。
另外,此處要修改下 html-webpack-plugin 插件配置的模板文件,因爲需要加入全局變量,所以加入相應的script即可。以 public -> index.html 爲例:

<!DOCTYPE html> 
<html lang="en"> 
 <head> //歡迎加入前端全棧開發交流圈一起吹水聊天學習交流:864305860
 <meta charset="utf-8"> 
 <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"> 
 <meta name="theme-color" content="#000000"> 
 <!-- 
  code here 
 -->
 </head> 
 <body> 
 <noscript> 
  You need to enable JavaScript to run this app. 
 </noscript> 
 <div id="root"></div> 
 <!-- 
  code here 
 -->
<!-- 新插入的兩個js -->
 <script src="http://st01.chrstatic.com/themes/chr-cdn/react/v0.14.8/react.min.js"></script> 
 <script src="http://st01.chrstatic.com/themes/chr-cdn/react/v0.14.8/react-dom.min.js"></script> 
 </body> //歡迎加入前端全棧開發交流圈一起吹水聊天學習交流:864305860
</html> 

問:既然瀏覽器裏面都有了全局變量,如window.React,那麼代碼裏面其實就不用 import React from 'react' 了,更進一步,如果連react都不用引了,那麼設置externals又有什麼用呢(這個地方好好縷縷,是不是這個理)?
答:如果按照上面所說,去掉import和external,build出來的文件是可以順利的在瀏覽器端運行的。但是如果開發的時候是起的server,那麼server端就沒法分析引用了,也就沒法做到熱更新了,另外,對於前後端同構來說,服務端也是找不到依賴的。所以,如果你是開着靜態文件的監聽,並且手動刷新瀏覽器的話,不import和external理論上是沒問題的。

安裝sass或less(以sass爲例)

npm install sass-loader node-sass --save-dev

或者

npm install less-loader less --save-dev

安裝後修改config -> webpack.config.dev.js 和 webpack.config.prod.js,分別在css的loader配置裏面修改兩處:
一是 test: /.css$/ 增加scss和sass;二是use裏面最後再加個loader,直接加 "sass-loader" 就可以了,也不用配置別的了(less同)。

//test: /\.css$/ 
test: /\.(css|scss|sass)$/ 
... //歡迎加入前端全棧開發交流圈一起吹水聊天學習交流:864305860
use:[ 
 { 
 ... 
 }, 
 "sass-loader"
]

添加ant-design

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

在config -> webpack.config.dev.js 和 webpack.config.prod.js 裏(或者 .babelrc 文件)的babel-loader的options配置裏,加入如下代碼:

plugins: [ 
 ['import', { libraryName: 'antd', style: 'css' }] // `style: true` 會加載 less 文件 
]//歡迎加入前端全棧開發交流圈一起吹水聊天學習交流:864305860

如果啓用了 style:true 那就必須是裝less了

結語

感謝您的觀看,如有不足之處,歡迎批評指正。

本次給大家推薦一個免費的學習羣,裏面概括移動應用網站開發,css,html,webpack,vue node angular以及面試資源等。
對web開發技術感興趣的同學,歡迎加入Q羣:864305860,不管你是小白還是大牛我都歡迎,還有大牛整理的一套高效率學習路線和教程與您免費分享,同時每天更新視頻資料。

最後,祝大家早日學有所成,拿到滿意offer,快速升職加薪,走上人生巔峯。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章