配置React开发环境教程

这是一篇新手向文章,主要是记录一下使用过程,希望能给予别人一些帮助和提示

用 Yarn 做包管理
用 Babel 做jsx和es6语法编译器
Webpack 做模块管理和打包

教程是基于macOS的,Nodejs得提前安装好。我的Nodejs和npm的版本如下

node -v
v6.9.2

npm -v
3.10.9

Yarn安装和配置

我们在 macOS 下可以通过brew去安装,如下

brew update
brew install yarn

Yarn 下载的包或者模块都是跟npm一个源的,因为某些原因,下载速度非常慢,难受,所以我们得换源

Yarn 换源和npm的源是一致的,都是共享.npmrc的配置信息,所以修改给 npm 换源就是等于给 Yarn 换源,如下

npm set registry https://registry.npm.taobao.org
npm set disturl https://npm.taobao.org/dist
npm cache clean

通过查看.npmrc文件检查是否更换源成功

vim ~/.npmrc

项目初始化

打开你的终端,新建文件夹然后进入该文件夹,用yarn init去做初始化,过程类似npm init,会有几个选项需要你填写,你可以根据你的需要去填写,这里我就直接一路回车就可以了。

mkdir react-demo
cd react-demo
yarn init

init完之后,就会提示success Saved package.json,说明初始化成功,我们可以查看一下package.json有什么东西

vim package.json
{
    "name": "react-demo","version": "1.0.0","main": "index.js","license": "MIT"
}

webpack安装和配置

yarn add webpack webpack-dev-server path

安装完毕,你会发现当前目录多了个yarn.lock,这个文件是Yarn用来锁定当前的依赖,不用担心

现在,我们已经安装好webpack了,我们需要一个配置文件用来执行,如下

touch webpack.config.js

然后更新该文件内容为如下

const path = require('path');
module.exports = {
  entry: './client/index.js',output: {
    path: path.resolve('dist'),filename: 'index_bundle.js'
  },module: {
    loaders: [
      { test: /\.js$/,loader: 'babel-loader',exclude: /node_modules/ },{ test: /\.jsx$/,exclude: /node_modules/ }
    ]
  }
}

从配置文件内容可以看出,为了让webpack运行,我们需要一个入口entry和一个输出output

为了能让JSX代码或者是ES6的代码也能正常在浏览器运行,我们需要loaders去装载babel-loader

更多的loaders我们可以查看 webpack文档

Babel安装和配置

yarn add babel-loader babel-core babel-preset-es2015 babel-preset-react --dev

在webpack配置过程中,我们用到了babel-loader,除了这个外,我们同样需要babel的其他依赖

babel-preset-es2015babel-preset-react这两个是 Babel 的插件,告诉Babel将es2015react的代码编译为Vanilla JS

安装完毕,我们还需要去配置Babel,新建一个文件为.babelrc

touch .babelrc

然后更新该文件内容为如下

{
    "presets":[
        "es2015","react"
    ]
}

webpack中的loader的 babel-loader 就是根据这个去执行

配置入口文件

现在我们的目录结构如下

|-- node_modules
|-- .babelrc
|-- package.json
|-- webpack.config.js
|-- yarn.lock

我们需要创建新的文件夹,同时在新文件夹内新建index.jsindex.html文件

mkdir client
cd client
touch index.js
touch index.html

然后我们更新一下index.js的内容为

console.log('Hello world!')

同样地,我们也要更新一下index.html内容为

<!DOCTYPE html>
<html>
  <head>
    <meta charset="utf-8">
    <title>React App Setup</title>
  </head>
  <body>
    <div id="root">

    </div>
  </body>
</html>

index.html是我们react组件运行在浏览器上的载体,react组件编写是jsx,同时也用到了es6,由于大多数浏览器是不支持es6和jsx,所以我们必须通过Babel编译这些代码,然后绑定输出显示在index.html上。

同时我们还需要html-webpack-plugin包为我们生成html

cd ..
yarn add html-webpack-plugin

安装完成后,打开webpack.config.js然后添加下面配置信息

const path = require('path');

const HtmlWebpackPlugin = require('html-webpack-plugin');
const HtmlWebpackPluginConfig = new HtmlWebpackPlugin({
  template: './client/index.html',filename: 'index.html',inject: 'body'
})

module.exports = {

    ...

    module: {
        loaders: [
            ...
        ]
    },plugins: [HtmlWebpackPluginConfig]
}

我们引入html-webpack-plugin,然后创建它的实例,然后配置templatefilenameinject,其中inject: 'body'是告诉插件添加JavaScript到页尾,在闭合body标签前

为了可以运行它,我们需要配置package.json,在"dependencies": {}代码块前插入如下代码

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

然后我们就可以运行了

yarn start

终端出现如下内容

Project is running at http://localhost:8080/

我们打开浏览器,输入http://localhost:8080/,在开发者工具的Console,发现有一段信息为Hello world!

react安装与配置

yarn add react react-dom

然后进入client目录,创建组件

cd client
mkdir components
cd components
touch App.jsx
cd ../..

现在我们项目目录结构如下

|-- node_modules
|-- client
     |-- components
         |-- App.jsx
     |-- index.html
     |-- index.js
|-- .babelrc
|-- package.json
|-- webpack.config.js
|-- yarn.lock

然后我们更新一下App.jsx文件的内容如下

import React from 'react';

export default class App extends React.Component {
  render() {
    return (
     <div style={{textAlign: 'center'}}>
        <h1>Hello World Again</h1>
      </div>);
  }
}

我们还需要修改一下我们的入口文件index.js,替换内容为如下

import React from 'react';
import ReactDOM from 'react-dom';
import App from './components/App.jsx';

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

然后在终端输入yarn start

刷新http://localhost:8080/,就能看到Hello World Again

至此,通过 Yarn 包管理,配置webpack和Babel,去搭建编写react组件的开发环境的新手向教程就此完毕

欢迎访问我的博客~ https://www.linpx.com/

相关文章

react 中的高阶组件主要是对于 hooks 之前的类组件来说的,如...
我们上一节了解了组件的更新机制,但是只是停留在表层上,例...
我们上一节了解了 react 的虚拟 dom 的格式,如何把虚拟 dom...
react 本身提供了克隆组件的方法,但是平时开发中可能很少使...
mobx 是一个简单可扩展的状态管理库,中文官网链接。小编在接...
我们在平常的开发中不可避免的会有很多列表渲染逻辑,在 pc ...