配置React开发环境教程

in Tutorials with 2 comments

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

用 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 config set registry 'https://registry.npm.taobao.org'

通过查看是否换源成功

yarn config get registry

项目初始化

打开你的终端,新建文件夹然后进入该文件夹,用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$/, loader: 'babel-loader', 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组件的开发环境的新手向教程就此完毕

Responses
  1. Kay

    马克住,据说React很弱?

    Reply
    1. @Kay

      哪里弱了?我都用了好久了···

      Reply