react+webpack开发环境配置

时间:2020-12-27 22:11:32

  react是目前非常热门的前端框架,提倡组件化开发。所谓的组件,简单理解,就是一个独立的页面部件(包括页面模版,样式,逻辑等),它是一个独立的整体。

  webpack,是一个模块打包工具,其主要功能,就是将浏览器端无法识别的代码,通过各种loader和plugin,生成浏览器可用的代码。比如,我们可以在浏览器端使用ES2015和JSX编码的文件。

  在使用react进行组件化开发之前,我们首先需要配置一个我们可以使用的开发环境,下面,我们将一步步讲解,配置一个基本的开发环境。其中安装的文件都是当前最新版本。在开始之前,请先保证你已经安装了node。

1. 创建测试项目

  为了可以让我们每一步都可以进行测试,了解其中都做了什么,我们提前编写我们的测试项目。大家可以先不用深入理解。(在我们以后的项目中,我们可能会用JSX文件和sass文件,在这里我们尽量真实且简单的还原项目)。

  1)首先我们创建一个项目文件夹,名为test

  2)在文件中添加index.jsx,hello.jsx, index.scss,  index.html

 // index.scss

 $color: #f40;

 h1 {
color: $color;
}
 // hello.jsx
module.exports = 'Hello React';
 // index.jsx
// 引入react和react-dom模块
// 使用ES2015模块导入语法
import React from 'react';
import ReactDOM from 'react-dom'; // 引入自定义的hello.jsx
var text = require('./hello.jsx'); // 引入我们编写的sass文件
require('./index.scss'); // 编写一个简单的组件
class App extends React.Component {
render(){
return (
<h1>{text}</h1>
);
}
}; // 创建一个组件实例,将组件挂载到文档结构中
ReactDOM.render(<App />, document.body);
 // index.html

 <!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>My test</title>
</head>
<body>
<script type="text/javascript" src="bundle.js"></script> // bundle.js是由webpack自动生成的文件,文件名通过配置webpack设置
</body>
</html>

  以上是我们项目的基本结构。

  为了方便项目文件的管理,我们使用npm,在项目根目录下使用npm init --yes,在根目录下生成一个package.json,管理项目依赖等。

2. 安装webpack

  1)以命令行工具的形式使用webpack时,在全局安装webpack。

  npm install webpack -g

  2) 编写自己的构建脚本,或由项目指定需要依赖的webpack,本地安装,webpack只是构建工具的角色,应该安装在dev-dependencies中,但是,目前我们只使用命令行工具,这种安装方式,只是作为介绍,在之后的搭建过程中并不会用到。

  npm install webpack --save-dev

3. 配置基本的webpack

  在项目根目录下添加webpack.config.js配置文件,它是一个Node.js模块格式的配置文件,直接导出一个配置对象。

 // 用于拼接路径
var path = require('path'); module.exports = {
// 指定项目入口
entry: path.resolve(__dirname, 'index.jsx'), // 对输出结果描述
output: {
// 输出路径
path: path.resolve(__dirname, 'build'),
// 输出的文件名
filename: 'bundle.js'
}, // 配置模块使用的加载器
module: {
loaders: [
{
// 假设我们拥有一个编译sass加载器
// 匹配字符串
test:/\.scss$/,
// 使用的加载器,不可以省略加载器的后缀-loader
loaders:['style-loader', 'css-loader', 'sass-loader']
}
}
}

4. babel,sass加载器

  可以从我们的项目结构中发现,我们使用了.jsx文件和.scss文件,浏览器中无法正常使用这类文件,我们通过添加加载器,将进行解析,以便浏览器使用。

  1)babel加载器

  npm install babel-core babel-loader --save-dev

  2)配置.babelrc文件

    在项目根目录下创建一个.babelrc文件,存放一个对象,分别用presets字段存放规则,plugins字段存放插件,目前我们只用到ES2015和react规则

  npm install babel-preset-es2015 babel-preset-react --save-dev // 添加规则
  {
  "presets": ["react", "es2015"]
  }

  3) sass加载器

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

  4) 配置webpack.config.js配置文件

     // 模块部分更新为下面代码

     module: {
loaders: [
{
test:/\.scss$/,
loaders:['style-loader', 'css-loader', 'sass-loader']
},
{
test:/\.jsx?$/,
loaders: ['babel-loader']
}]
},

  此时即可正常加载.scss和.jsx文件。

5. 安装react和react-dom

 npm install react react-dom --save

  到此,我们在项目根目录下执行webpack已经已经在根目录下生成一个bundle.js文件,我们可以正常在index.html文件文件引用,并且在浏览器中查看。

react+webpack开发环境配置

react+webpack开发环境配置

之后的内容,我们将会介绍webpack的插件的用法,以及webpack-dev-server配置方法。

1. html-webpack-plugin

  我们可以发现我们index.html文件中,只是一个空的HTML结构和引入了生成的bundle.js文件,因此我们可以利用html-webpack-plugin插件来自动生成index.js文件。

  1) 下载插件

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

  2)配置webpack.config.js文件

  首先在文件头部引入插件,然后在添加一个plugins字段,并在其中一个插件对象实例。

 var HtmlWebpackPlugin = require('html-webpack-plugin');

 module.exports ={
plugins: [
new HtmlWebpackPlugin({
title: 'My test'
})
]
}

  此时我们删除index.html和bundle.js,webpack自动在build路径下创建这两个文件。

2. webpack-dev-server

  我们可以使用webpack --wacth来监控代码,只要代码一修改,自动更新bundle.js,但是浏览器的网页还需要手动刷新。在开发工程中,非常的不方便。webpack-dev-server为我们解决了这个问题,它是一个小型服务器,在开发过程中可以实时刷新网页。

  下面我们来安装配置webpack-dev-server。

  1)全局安装webpack-dev-server

  npm install webpack-dev-server -g

  2)配置webpack-dev-server

     // 添加devServer字段,其中字段变动比较大,配置时需要根据文档进行配置
devServer: {
historyApiFallback: true,
inline: true,
contentBase:'./build/',
port:'8086' // 我电脑上默认的8080端口无法访问,所以设置port为8086
},

  3)设置运行快捷方式

  在package.json中的scripts字段中添加下面一行,在命令行中输入npm run dev,直接启动webpack-dev-server,可以在指定端口进行访问。

   "scripts": {
"dev": "webpack-dev-server"
},

3. 组件热加载(HMR)

  我们在上述描述下,搭建的环境,每修改一次代码,页面都会整体刷新一次,我们更希望,页面局部刷新修改的组件。因此就有了组件热加载这个概念。我们可以直接安装babel-preset-react-hmre实现HMR。

  npm install babel-preset-react-hmre --save-dev

.babelrc中的配置改为:

 {
"presets": ["react", "es2015"],
"env": {
"development": {
"presets": ["react-hmre"]
}
}
}

并将启动命令改为:

"scripts": {
"dev": "webpack-dev-server --hot"
},

此时我们在命令行输入npm run dev,即可。

完成项目github地址:https://github.com/DiligentYe/react-webpack-env