最近在研究小程序这方面的东西，使用到了京东基于 React 的小程序开发框架 Taro ，相比 mpvue 和 uni-app 这两个框架来说，Taro 显得更优雅，更稳重，大厂在迭代，就是不一样，一句话 ，就是坑少一点～

前置知识

看本篇教程前需要你掌握 dva ,React Hooks ,Redux ,还有小程序的开发流程。希望你知其然，并知其所以然。如果你不具备以上任意一点，建议先停下来，下面我给出地址，先自行学习之后再过来看我这篇文章 。

正式开始

安装 Taro脚手架# 使用 npm 安装 CLI

$ npm install -g @tarojs/cli

# OR 使用 yarn 安装 CLI

$ yarn global add @tarojs/cli

# OR 安装了 cnpm，使用 cnpm 安装 CLI

$ cnpm install -g @tarojs/cli

因为我电脑安装了 cnpm 镜像源，所以下文我都会用 cnpm

脚手架完成后使用脚手架初始化一个新项目

在你需要建立项目的文件夹打开 CMDtaro init test//我们演示的项目名叫test

然后跟着流程走，这边为了减少你的学习成本，建议不要选择 Typescript ,css选择less,模版选择默认模版。

最后成功之后，用你的编辑器打开test目录。

你的目录结构跟我的应该是一样的

先删除 ./src/pages 下面的 index 文件夹。

然后命令行在test 目录打开，安装我们需要用的扩展cnpm install --save @tarojs/async-await //没想到吧 在Taro里面使用 async和 await 需要安装这个扩展

cnpm install --save redux @tarojs/redux @tarojs/redux-h5 redux-thunk redux-logger //Redux全家桶

cnpm install --save dva-core dva-loading //dva

cnpm install --save taro-axios //在Taro里面使用axios 需要安装他

这四个命令安装完之后，打开./src 目录 ，新建两个文件夹 ，一个叫 utils 一个叫 models 注意这两个文件夹应该跟你的 pages 文件夹同级。

在 utils 文件夹下面新建文件 dva.js 写上下面的内容 注册dvaimport { create } from 'dva-core';

import { createLogger } from 'redux-logger';

import createLoading from 'dva-loading';

let app;

let store;

let dispatch;

function createApp(opt) {

// redux日志

// opt.onAction = [createLogger()];

app = create(opt);

app.use(createLoading({}));

if (!global.registered) opt.models.forEach(model => app.model(model));

global.registered = true;

app.start();

store = app._store;

app.getStore = () => store;

dispatch = store.dispatch;

app.dispatch = dispatch;

return app;

}

export default {

createApp,

getDispatch() {

return app.dispatch;

}

}

在 utils 文件夹下面新建文件 request.js 写上下面的内容 封装一个简单的axios 实际你的项目中可能不一样import axios from "taro-axios";

const baseURL = `https://blog.xiaohuwei.cn`

const service = axios.create({

baseURL: baseURL,

withCredentials: true,

timeout: 300000

});

service.interceptors.response.use(

response => {

return response.data;

},

error => {

return Promise.reject(error)

})

export default service

在 model 文件夹下面新建文件 model.js 写上下面的内容 连接你每个页面的仓库注册到全局import index from '../pages/index/model';

export default [index];

你会发现我们刚才吧 index 文件夹已经删除了 ，这里先这样写，后面我在做说明。

下一步 修改 ./src/app.jsx 作用就是把我们所有的仓库连接进来 方便你学习 下面给出修改后的全部代码import '@tarojs/async-await'

import Taro, { Component } from '@tarojs/taro'

import Index from './pages/index'

import dva from './utils/dva';

import models from './models/models';

import { Provider } from '@tarojs/redux';

import './app.less'

const dvaApp = dva.createApp({

initialState: {},

models: models,

});

const store = dvaApp.getStore();

class App extends Component {

config = {

pages: [

'pages/index/index'

],

window: {

backgroundTextStyle: 'light',

navigationBarBackgroundColor: '#fff',

navigationBarTitleText: 'WeChat',

navigationBarTextStyle: 'black'

}

}

componentDidMount() { }

componentDidShow() { }

componentDidHide() { }

componentDidCatchError() { }

// 在 App 类中的 render() 函数没有实际作用

// 请勿修改此函数

render() {

return (

)

}

}

Taro.render(, document.getElementById('app'))

最后一步

在你项目 根目录 ，为了跟我保持一致，希望你在根目录新建一个叫 page.js的文件 这个文件我们用来自动生成新页面，包含新页面的 ui层 service层 和 model层方便快速开发。内容如下/**

* pages模版快速生成脚本,执行命令 npm run temp `文件名`

*/

const fs = require('fs');

const dirName = process.argv[2];

if (!dirName) {

console.log('文件夹名称不能为空！');

console.log('示例：npm run temp test');

process.exit(0);

}

// 页面模版

const indexTep = `import Taro,{useEffect} from '@tarojs/taro';

import { View,Text } from '@tarojs/components';

import { connect } from '@tarojs/redux';

import './index.less';

const ${titleCase(dirName)} = props =>{

const {${dirName},loading} = props;

useEffect(() => {

console.log(props)

}, [])

return (

正如你所见这是你的${dirName}页面

)

}

${titleCase(dirName)}.config = {

navigationBarTitleText: '${dirName}'

}

//全局样式继承 你可以关掉

${titleCase(dirName)}.options = {

addGlobalClass: true

}

export default connect(

({

${dirName},

loading

})=>({

${dirName},

loading

}))(${titleCase(dirName)})

`;

// less文件模版

const lessTep = `

.${dirName}-page {

}

`;

// model文件模版

const modelTep = `import * as ${dirName}Api from './service';

export default {

namespace: '${dirName}',

state: {

keai:'测试数据666'

},

effects: {

* effectsDemo(_, { call, put }) {

const { status, data } = yield call(${dirName}Api.demo, {});

if (status === 'ok') {

yield put({ type: 'save',

payload: {

topData: data,

} });

}

},

},

reducers: {

save(state, { payload }) {

return { ...state, ...payload };

},

},

};

`;

// service页面模版

const serviceTep = `import Request from '../../utils/request';

export const demo = (data) => {

return Request({

url: '路径',

method: 'POST',

data,

});

};

`;

fs.mkdirSync(`./src/pages/${dirName}`); // mkdir $1

process.chdir(`./src/pages/${dirName}`); // cd $1

fs.writeFileSync('index.js', indexTep);

fs.writeFileSync('index.less', lessTep);

fs.writeFileSync('model.js', modelTep);

fs.writeFileSync('service.js', serviceTep);

console.log(`模版${dirName}已创建,请手动按照格式增加到./src/models`);

function titleCase(str) {

const array = str.toLowerCase().split(' ');

for (let i = 0; i < array.length; i++) {

array[i] = array[i][0].toUpperCase() + array[i].substring(1, array[i].length);

}

const string = array.join(' ');

return string;

}

process.exit(0);

完成之后 去 package.json 里面的 scripts 添加一条 命令 "temp": "node page.js"

如果你能够走到这一步 ，说明你已经成功了 ，跟我的目录结构 对照一下

命令行在你的项目目录打开，我们来使用 脚本生成第一个页面 indexnpm run temp index

你会发现你的./src/pages 目录下多了 index 文件夹 并且文件夹下面已经为你初始化好了所有你需要的文件，但是并没有结束。

就是上文提到的 ，每次新建一个页面都需要去 ./src/models/models.js 手动 按照我给你的格式引入一次，因为我这个组件叫 index，所以我给你的默认就是 index,所以我这里不用改，你做项目的时候，是需要手动加的。

试试效果！npm run dev:weapp

好啦，所有的都完成啦，开始开发你的小程序吧！～

说下 Taro的注意事项

当你 使用到了 图片这些静态资源的时候 ，需要使用 import 的语法引用。

代码仓库