DIV CSS 佈局教程網

webpack 2.x 打造 React 開發環境的完整設定教學
編輯:JavaScript技巧     

本文分享如何使用 webpack 2.x 建置一套 React 的基本開發環境,內容整理如下。

版本基準:webpack 2.2、React 15.4.2

webpack 從 1.x 升級到 2.x 時替換了幾個關鍵介面,其中 module.loaders 已被棄用。官方目前也不再推薦 1.x,因此以下內容都是依 2.2 版本重新梳理的設定,足以支撐中小型 Web 應用的開發需求,後續可以再逐步微調設定檔。

如果你以前用過 webpack,需要調整的地方其實不多。下文預設你沒接觸過這類打包工具(若懂 npm 與 JSX 更好),以新手視角逐步說明。

假如你的 React 專案是透過以下三個 CDN 檔案在瀏覽器端編譯 JSX,那麼其實用不到 webpack 來搭建開發環境。

 <script src="https://cdn.bootcss.com/react/15.4.2/react.min.js"></script>
<script src="https://cdn.bootcss.com/react/15.4.2/react-dom.min.js"></script>
<script src="https://cdn.bootcss.com/babel-standalone/6.22.1/babel.min.js"></script>

但產品上線階段並不建議這麼做,原因有兩個:一是使用者得額外下載這三個檔案,白白消耗頻寬;二是下載完還要在瀏覽器端編譯 JSX,同樣浪費時間與資源。

反過來說,如果把開發階段的程式碼打包編譯成一支 JS 檔再上線,就能把 HTTP 請求壓縮成一個,而且使用者端不必再花時間編譯,直接執行上線前就編譯好的程式碼即可。

兩種做法在 HTML 標籤上也有差別:前者 script 的 type 是 "text/babel",後者則是 "text/javascript"。

具體怎麼做?

一、安裝 Node.js,使用它附帶的 npm 套件管理工具。之所以要用 npm,是因為後續要下載 React 相依套件、Babel 相依套件與 webpack 工具,用 npm 會輕鬆很多;不用也行,但無疑會平添許多麻煩。

二、建立一個專案資料夾,在資料夾內開啟終端機(Windows 下可用 Shift + 右鍵選「在此開啟命令視窗」),執行 npm init,若沒有特殊需求,一路按 Enter 到底即可。

三、在終端機執行以下指令,把需要的相依套件與工具一次裝好。

複製代碼 代碼如下:
npm install react react-dom babel-loader babel-core babel-preset-es2015 webpack webpack-dev-server --save-dev

四、建立 webpack 設定檔。在根目錄(與 package.json 同層)新增 webpack.config.js,寫入以下內容。

 // webpack.config.js var webpack = require("webpack"); var path = require("path"); module.exports = { entry: './dev/entry.jsx', // 入口文件 devtool: 'source-map', // 調試時定位到編譯前的代碼位置,推薦安裝react插件 output: { path: path.resolve(__dirname, "./dist/js/"), filename: 'bundle.js' // 打包輸出的文件 }, module: { rules: [{ test: /\.jsx?$/, // test 去判斷是否為.js或.jsx,是的話就是進行es6和jsx的編譯 exclude: /(node_modules|bower_components)/, loader: 'babel-loader', query: { presets: ['es2015', 'react'] } }] }, resolve: { // 現在你import文件的時候可以直接使用import Func from './file',不用再使用import Func from './file.js' extensions: ['.js', '.jsx', '.json', '.coffee'] } }; 

目錄結構如下:

 app |__dev | |__components | |__entry.jsx |__dist | |__css | |__js | |__bundle.js | |__index.html |__node_modules |__package.json |__webpack.config.js

關於這份設定檔,有幾點需要補充:

1、標紅部分可依需求自行調整。

2、React 專案的原始檔可以用 .js 也可以用 .jsx,但最終在 HTML 中被引用的輸出檔必須是 .js。

3、本設定把入口檔放在 dev 目錄、輸出檔放在 dist 目錄,實際路徑可自行決定。

4、module.rules 是 2.x 新增的介面,用來取代舊的 module.loaders。

5、query 這段拿掉會報錯;也可以把規則寫進 package.json,寫法請參考官方文件。

五、在 package.json 的 scripts 區塊加入以下內容。

 "scripts": { "test": "echo \"Error: no test specified\" && exit 1", "start": "webpack-dev-server --hot --open --content-base ./dist/", "deploy": "webpack -p --progress --config webpack.config.js" },

註:--content-base 用來指定根 HTML 檔所在位置。

六、開發階段在終端機執行 npm start 即可自動編譯並重新整理;要產出正式環境程式碼則執行 npm run build。

註:webpack-dev-server 的自動編譯與瀏覽器刷新並不會把編譯結果寫入磁碟,而是留在記憶體中,因此此時 HTML 裡引用的 script src 只要寫 "bundle.js"、不需要任何路徑。若你在 webpack.config.js 的 output 中指定了 publicPath,情況又會不同。

附:webpack 常用參數,可分別寫進 scripts 的指令中。

  • webpack:開發環境編譯
  • webpack -p:正式環境編譯並壓縮
  • webpack --watch:持續監聽檔案變動並即時編譯(速度非常快)
  • webpack -d:產生 source maps

eslint 支援:

 npm i eslint babel-eslint eslint-plugin-react --save-dev

接著新增一個 .eslintrc 檔,寫入 React 的基本參數。

 { "plugins": ["react"], "extends": ["eslint:recommended", "plugin:react/recommended"], "parser": "babel-eslint" }

建議安裝編輯器對應的 eslint 外掛,這樣就能在介面上即時看到錯誤提示。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved