React + Webpack (jsx +less) -云博客

React + Webpack (jsx +less)

# 前端 2024-05-05 02:11 0 45 来源：云博客

React项目的初始化、webpack的安装、如何使用jsx和less。

一、初始 React 项目

　　react项目的初始化比较简单，我用的就是react的脚手架。三种方式：

　　1、NPM

npm init react-app my-app

　　2、NPX

npx create-react-app my-app

　　3、Yarn

yarn create react-app my-app

　　my-app 是项目的名字，运行命令时会在当前目录下自动创建一个名字叫作 my-app 的项目文件夹。命令运行完毕，简单的React项目就初始化完成了。项目的初始的代码结构式这个样子的：

　　进入项目文件，你可以通过 npm run start 来运行项目，会跳出一个React的欢迎页

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

二、Webpack安装程序

　　Webpack

　　　　WebPack可以看做是模块打包机：它会分析你的项目结构，找到JavaScript模块以及其它的一些浏览器不能直接运行的拓展语言（less、jsx、Scss、TypeScript等），并将其打包为合适的格式以供浏览器使用。

　　为什么要用 WebPack ？

　　　　1、模块化

　　　　　　在webpack看来一切都是模块！这就是它不可不说的优点，包括你的JavaScript代码，也包括CSS和fonts以及图片等等等，只有通过合适的loaders，它们都可以被当做模块被处理。

　　　　2、预处理（Less，Sass，ES6，TypeScript……）

　　　　3、主流框架脚手架支持（Vue，React，Angular）

　　　　4、庞大的社区（资源丰富，降低学习成本）

　　1、开始安装Webpack

　　　　使用 webpack 首先你需要安装 webpack-dev-server 在本地环境中为捆绑的应用程序提供服务、webpack-cli 在配置文件中来配置你的Webpack 设置。

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

　　2、修改 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.

　　3、编辑 webpack.base.config.js

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

　　　　文件说明：

　　　　　　(1) 我们希望使用 “./src/index.js” 文件作为入口点。

　　　　　　(2) 绑定的文件最后生成的js文件，叫做: bundle.js .

　　　　　（3）生成的位置在：“/public”

　　4、修改一下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‘);

　　5、npm start

　　　　OK，我们已经使用 webpack 将项目的启动脚本配置好了。下面就是使用 npm start 来验证我们的启动命令是否成功。　　　

　　　　项目启动成功，接下来访问地址 localhost:8080 来访问一下。

　　　　其中我们在 src/index.js 里面 console.log 的信息已经显示在了浏览器里边，说明 index.js 已经通过 webpack 编译成了 bundle.js。

三、配置 babel

　　babel 是一个广泛的转码器，可以将 ES6 代码转化为 ES5 代码。从而在现有的环境中执行。

　　1、安装插件

　　　　在项目根目录下指定下面命令，作用是使得 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

　　2、编辑 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" ]}

　　3、修改 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-PWAserviceWorker.unregister();

　　然后将 App.css 改名为 App.less, 内容不需要改，如下图：

　　OK，现在执行命令 npm start，访问 localhost:8080 看一下结果.

　　成功。

四、使用 webpack 打包项目

　　1、首先我在 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/637var 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-265344421var 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

　　2、在项目根目录下创建 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 distapp.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

　　3、修改 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 } };

　　　　安装 html-webpack-plugin：

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

　　4、package.json

　　　　将 script 中的 build 换成如下语句：

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