基礎搭建 Webpack4+React (jsx + less)

React項目的初始化、webpack的安裝、如何使用jsx和less。javascript

1、初始 React 項目css

  react項目的初始化比較簡單,我用的就是react的腳手架。三種方式html

  一、NPMjava

npm init react-app my-app

  二、NPXnode

npx create-react-app my-app

  三、Yarnreact

yarn create react-app my-app

 

  my-app 是項目的名字,運行命令時會在當前目錄下自動建立一個名字叫做 my-app 的項目文件夾。命令運行完畢,簡單的React項目就初始化完成了。項目的初始的代碼結構式這個樣子的:webpack

  進入項目文件,你能夠經過 npm run start 來運行項目,會跳出一個React的歡迎頁git

my-app
├── README.md
├── node_modules
├── package.json
├── .gitignore
├── public
│   ├── favicon.ico
│   ├── index.html
│   └── manifest.json
└── src
    ├── App.css
    ├── App.js
    ├── App.test.js
    ├── index.css
    ├── index.js
    ├── logo.svg
    └── serviceWorker.js

 

2、Webpack安裝程序github

  Webpackweb

    WebPack能夠看作是模塊打包機:它會分析你的項目結構,找到JavaScript模塊以及其它的一些瀏覽器不能直接運行的拓展語言(less、jsx、Scss、TypeScript等),並將其打包爲合適的格式以供瀏覽器使用。

  爲何要用 WebPack ?

    一、模塊化

      在webpack看來一切都是模塊!這就是它不可不說的優勢,包括你的JavaScript代碼,也包括CSS和fonts以及圖片等等等,只有經過合適的loaders,它們均可以被當作模塊被處理。

    二、預處理(Less,Sass,ES6,TypeScript……)

    三、主流框架腳手架支持(Vue,React,Angular)

    四、龐大的社區(資源豐富,下降學習成本)

  

  一、開始安裝Webpack

    使用 webpack 首先你須要安裝 webpack-dev-server 在本地環境中爲捆綁的應用程序提供服務、webpack-cli 在配置文件中來配置你的Webpack 設置。

npm install --save-dev webpack webpack-dev-server webpack-cli

  

  二、修改 package.json

     主要修改 package.json 中的啓動項

       

"scripts": {
  "start": "webpack-dev-server --config config/webpack.base.config.js --mode development",
  ...
}

        

    腳本將 webpack-dev-server 與名爲 webpack.base.config.js 一塊兒使用。我在項目的根目錄下建立了一個 config 文件夾,裏面用來存放 webpack 的配置文件。The --mode development flag just adds default Webpack configurations which came with Webpack 4.

      

  

  三、編輯 webpack.base.config.js

module.exports = {
    entry: './src/index.js',
    output: {
      path: __dirname + '/public',
      publicPath: '/',
      filename: 'bundle.js'
    },
    devServer: {
      contentBase: './public'
    }
};

    文件說明:

      (1) 咱們但願使用 「./src/index.js」 文件做爲入口點。

      (2) 綁定的文件最後生成的js文件,叫作: bundle.js .

      (3)生成的位置在:「/public」

  

  四、修改一下public/index.html 和 src/index.js 中的內容

    由於咱們初步使用 webpack 來啓動咱們的項目,因此像是 svg圖片react的識別都尚未配置。因此先將這兩個文件進行修改,這些修改不會影響到以後我們的搭建。將兩個文件修改爲下面的樣子。

    public/index.html

<!DOCTYPE html>
<html lang="en">
  <head>
    <title>React App</title>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
    <base href="/">
  </head>
  <body>
    <noscript>You need to enable JavaScript to run this app.</noscript>
    <div id="root"></div>
    <script src="./bundle.js"></script>
  </body>
</html>

    src/index.js

console.log('My Minimal React Webpack Babel Setup');

  五、npm start

    OK,咱們已經使用 webpack 將項目的啓動腳本配置好了。下面就是使用 npm start 來驗證咱們的啓動命令是否成功。   

    

    項目啓動成功,接下來訪問地址 localhost:8080 來訪問一下。

    

    其中咱們在 src/index.js 裏面 console.log 的信息已經顯示在了瀏覽器裏邊,說明 index.js 已經經過 webpack 編譯成了 bundle.js。

 

3、配置 babel

  babel 是一個普遍的轉碼器能夠將 ES6 代碼轉化爲 ES5 代碼。從而在現有的環境中執行。

  一、安裝插件

    在項目根目錄下指定下面命令,做用是使得 babel 正常執行:

npm install --save-dev @babel/core @babel/preset-env

     爲了將它鏈接到Webpack,還須要安裝一個加載器:

npm install --save-dev babel-loader

     還須要一個配置,來將 React 的 jsx 語法轉化成 JavaScript:

npm install --save-dev @babel/preset-react

  二、編輯 webpack.base.config.js 文件

    在 webpack.base.config.js 文件中添加代碼:

    module: {
      rules: [
          {
              test: /\.(js|jsx)$/,
              exclude: /node_modules/,
              use: ['babel-loader', 'eslint-loader']
          },
          {
              test: /\.(css|less)$/,
              use:["style-loader", "css-loader", "less-loader"]
          },
          {
              test: /\.svg$/,
              use: ['file-loader']
          }
      ]
    },
    resolve: {
      extensions: ['*', '.js', '.jsx', '.css', '.less']
    }

 

   

    這些代碼的做用是 是代碼識別 js、jsx、css、less、svg圖片文件的。

    這裏要下載幾個 loader 和 plugin:

npm install --save-dev style-loader css-loader less less-loader eslint-loader file-loader extract-text-webpack-plugin@next

    在項目根目錄下建立 .babelrc 文件

      .babelrc

{
  "presets": [
    "@babel/preset-env",
    "@babel/preset-react"
  ]
}

  三、修改 src/index.js 文件

    webpack 已經認less和css文件了。如今咱們修改一下index.js

import React from 'react';
import ReactDOM from 'react-dom';
import './index.css';
import App from './App';
import * as serviceWorker from './serviceWorker';

ReactDOM.render(<App />, document.getElementById('root'));

// If you want your app to work offline and load faster, you can change
// unregister() to register() below. Note this comes with some pitfalls.
// Learn more about service workers: http://bit.ly/CRA-PWA
serviceWorker.unregister();

  而後將 App.css 更名爲 App.less, 內容不須要改,以下圖:

  

  OK,如今執行命令 npm start,訪問 localhost:8080 看一下結果.

  

  成功。

 

4、使用 webpack 打包項目

  一、首先我在 config 文件夾中建立 path.js、webpack.opt.config.js、 webpack.prod.config.js 三個文件

    path.js

      path 的做用是 提供path路徑的,自定義的path。

var path = require('path');
var fs = require('fs');

// Make sure any symlinks in the project folder are resolved:
// https://github.com/facebookincubator/create-react-app/issues/637
var appDirectory = fs.realpathSync(process.cwd());
function resolveApp(relativePath) {
  return path.resolve(appDirectory, relativePath);
}

// We support resolving modules according to `NODE_PATH`.
// This lets you use absolute paths in imports inside large monorepos:
// https://github.com/facebookincubator/create-react-app/issues/253.

// It works similar to `NODE_PATH` in Node itself:
// https://nodejs.org/api/modules.html#modules_loading_from_the_global_folders

// We will export `nodePaths` as an array of absolute paths.
// It will then be used by Webpack configs.
// Jest doesn't need this because it already handles `NODE_PATH` out of the box.

// Note that unlike in Node, only *relative* paths from `NODE_PATH` are honored.
// Otherwise, we risk importing Node.js core modules into an app instead of Webpack shims.
// https://github.com/facebookincubator/create-react-app/issues/1023#issuecomment-265344421

var nodePaths = (process.env.NODE_PATH || '')
  .split(process.platform === 'win32' ? ';' : ':')
  .filter(Boolean)
  .filter(folder => !path.isAbsolute(folder))
  .map(resolveApp);

// config after eject: we're in ./config/
module.exports = {
  appBuild: resolveApp('build'),
  appPublic: resolveApp('public'),
  appHtml: resolveApp('public/index.html'),
  appIndexJs: resolveApp('src/index.js'),
  appPackageJson: resolveApp('package.json'),
  appSrc: resolveApp('src'),
  yarnLockFile: resolveApp('yarn.lock'),
  appNodeModules: resolveApp('node_modules'),
  nodePaths: nodePaths
};

    webpack.opt.config.js

      webpack.opt.config.js 是在打包時作 css代碼 優化的

var OptimizeCssAssetsPlugin = require('optimize-css-assets-webpack-plugin');
var UglifyJsPlugin = require('uglifyjs-webpack-plugin');

module.exports = {
  optimization: {
    minimizer: [
      new UglifyJsPlugin({
        uglifyOptions: {
          mangle: {
            keep_fnames: true,
          },
        },
      })
    ],
  },
  plugins: [
    new OptimizeCssAssetsPlugin()
  ],
}

    webpack.prod.config.js

      webpack.prod.config.js 用來將各個 config 文件融合到一塊兒

var webpack = require('webpack');
var merge = require('webpack-merge');

var baseConfig = require('./webpack.base.config');
var optimizationConfig = require('./webpack.opt.config');

const productionConfiguration = function (env) {
  const NODE_ENV = env.NODE_ENV ? env.NODE_ENV : 'development';
  return {
    plugins: [
      new webpack.DefinePlugin({ 'process.env.NODE_ENV': JSON.stringify(NODE_ENV) }),
    ]
  };
}

module.exports = merge.smart(baseConfig, optimizationConfig, productionConfiguration);  

    安裝  uglifyjs-webpack-plugin 和 webpack-merge :

npm install --save-dev uglifyjs-webpack-plugin
 npm install --save-dev webpack-merge

  

  二、在項目根目錄下建立 server 文件夾

    server 的做用是,打包成功以後,項目啓動一個server。能夠經過訪問 server 地址來直接訪問項目build以後生成的包。

      server/index.js

const express = require('express');
const path = require('path');
const http = require('http');

const app = express();

// Point static path to dist
app.use(express.static(path.join(__dirname, '..', 'build')));

const routes = require('./routes')
app.use('/', routes);

/** Get port from environment and store in Express. */
const port = process.env.PORT || '3000';
app.set('port', port);

/** Create HTTP server. */
const server = http.createServer(app);
/** Listen on provided port, on all network interfaces. */
server.listen(port, () => console.log(`Server Running on port ${port}`))

 

      routes/index.js

const path = require('path');
const router = require('express').Router();

router
  .get('/*', (req, res, next) => {
    const routePath = path.join(__dirname + '..', '..', '..','build/' + 'index.html');
    res.sendFile(routePath);
  })
module.exports = router;

 

    這裏面要安裝一個 express:  

npm install --save-dev express  

 

 

    

 

  三、修改 webpack.base.config.js

    webpack.base.config.js 最終版

const webpack = require('webpack');
var HtmlWebpackPlugin = require('html-webpack-plugin');
var ExtractTextPlugin = require('extract-text-webpack-plugin');
var paths = require('./paths');

module.exports = {
    entry: './src/index.js',
    output: {
      path: paths.appBuild,
      publicPath: '/',
      filename: 'bundle.js'
    },
    module: {
        rules: [
            {
                test: /\.(js|jsx)$/,
                exclude: /node_modules/,
                use: ['babel-loader', 'eslint-loader']
            },
            {
                test: /\.(css|less)$/,
                use:["style-loader", "css-loader", "less-loader"]
                // use: ExtractTextPlugin.extract({
                //   fallback: "style-loader",
                //   use: "css-loader!less-loader",
                // })
            },
            {
                test: /\.svg$/,
                use: ['file-loader']
            }
        ]
    },
    plugins: [
        new webpack.HotModuleReplacementPlugin(),
        new HtmlWebpackPlugin({ 
            template: './public/index.html', 
            filename: './index.html' 
        }),
        new ExtractTextPlugin('style.css')
    ],
    resolve: {
        extensions: ['*', '.js', '.jsx', '.css', '.less']
    },
    devServer: {
      contentBase: './public',
      hot: true
    }
  };

    標紅的部分是兩種 css 的 load 方式。

      直接使用 " use: [] " : 打包時,css會被打包到 bundle.js 裏面。

      使用 " use: ExtractTextPlugin.extract() " : plugin 中的 new ExtractTextPlugin('style.css') 聯用。打包時會將css文件分離開來進行打包,在 build 文件夾中生成一個 style.css 文件.

    安裝 html-webpack-plugin:

npm install --save-dev html-webpack-plugin 

  四、package.json

     script 中的 build 換成以下語句

"prestart:prod": "webpack --mode production --config config/webpack.prod.config.js --env.NODE_ENV=production --progress",
    "start:prod": "node server",

    

 

  5測試

    OK,所有配置完畢了,下面咱們來測試一下是否成功。

      運行命令 npm run start:prod 

     

      build 生成的文件,三個以下:

             

      運行成功,訪問 localhost:3000 訪問 build 好的包。

     

       

      執行命令: npm start

    

      

      訪問 localhost:8080:

    

相關文章
相關標籤/搜索