React v16 與 Webpack v4 的多特性模板專案

王下邀月熊發表於2019-03-03

題注:歡迎加入阿里南京前端團隊,歡迎關注阿里南京技術專刊瞭解更多訊息。

React & Webpack Boilerplate V4

React & Webpack Boilerplate V4 是筆者前端常用模板集錦專案 fe-boilerplate 的一部分,儘可能地使用無異議的工具,提供直觀且簡潔明瞭的方式;相較於 create-react-app,具有更好的可配置性與適應性,適合於中長期專案。支援最新的 Webpack 4 & React 16.3 版本,如果需要引入 TypeScript 支援,可以借鑑 react/webpack-ts 這個模板。

為了保證專案的純粹性,將原本 React Router,Redux,MobX 等常見的技術框架的使用遷移到了 fe-boilerplate 的其他模板專案中。也可以查閱 Webpack CheatSheet,或者 React CheatSheet現代 Web 開發基礎與工程實踐 瞭解更多 Web 開發實踐的知識。

配置與使用

下載或者克隆 fe-boilerplate,並且進入 react/webpack 子目錄:

# 安裝依賴
$ cnpm install

# 僅啟動 Web 開發伺服器
$ npm run dev

# 啟動 Web 開發伺服器與 Mock 伺服器
$ npm start

# 啟動 Storybook 服務,在進行元件開發時使用
$ npm run storybook

# 編譯為可釋出的包體
$ npm run build

# 使用 *.umd.* 配置檔案,編譯為庫
$ npm run build:lib

# 執行 ESLint
$ npm run lint

# 執行包體分析
$ npm run analyze
複製程式碼

如果我們是進行的多頁面應用開發,那麼可以在 webpack.config.base.js 檔案中新增更多的 Entry 與 HtmlWebpackPlugin 配置。

技術棧

  • 樣式

    • 支援使用 CSS Modules/SCSS/Less 等 CSS 模組化解決方案,對於潛在的類名過長導致的冗餘包體等問題可以參考 babel-plugin-jsx-nested-classname
    • 示例程式碼使用了 styled-components 作為 CSS-in-JS 庫。
    • 使用 PostCSS 作為 CSS 程式碼的後置 Polyfill 以及語法轉換支援,詳見 postcss.config.js 中的配置。
  • 約束

    • 使用 Prettier 作為程式碼格式化工具。
    • 強烈建議使用 ESLint 進行程式碼風格控制,可以使用 vscode-eslint 外掛以獲得更好的開發體驗;ESLint 規則推薦使用 eslint-config-airbnb
    • 可以使用 vscode-import-formatter 等格式化工具處理程式碼的細節風格,譬如引用順序等問題。
  • 測試

    • 使用 Jest 作為 Test Runner 以及單元測試框架。
    • 使用 Enzyme 作為 React 元件的測試框架。
  • 計算

開發態特性

  • 熱載入
  • 構建優化
    • 使用 DllPlugin 作為開發環境下公共程式碼提取工具以優化編譯速度生產環境。
    • 可以考慮使用 HappyPack, parallel-webpack 等工具提升 Webpack 的並行處理能力。

釋出態特性

  • 程式碼分割,Webpack 4 移除了 CommonChunksPlugin,替換以 optimization 與 splitChunks 配置項,詳細配置參考 webpack.config.prod.js
  • PWA 特性,使用 offline-plugin 新增便捷的 PWA 支援。
  • 服務端渲染,詳見 ssr/server
  • 程式碼優化,使用 Prepack & prepack-webpack-plugin 進行程式碼優化。

相關文章