Taro

👽 Taro['tɑ:roʊ]，泰罗·奥特曼，宇宙警备队总教官，实力最强的奥特曼。

简介

Taro 是一套遵循 React 语法规范的 多端开发 解决方案。现如今市面上端的形态多种多样，Web、React-Native、微信小程序等各种端大行其道，当业务同时在不同的端都要求有所表现的时候，针对不同的端编写多套代码的成本显然非常高，这时只编写一套代码就能适配到多端的能力就显得极为重要。

使用 Taro，我们只需书写一套代码，再通过 Taro 的编译工具，即可将源代码分别编译出在不同端（微信/百度/支付宝/字节跳动小程序、快应用、H5、React-Native 等）运行的代码。

学习资源

awesome-taro

掘金小册：Taro 多端开发实现原理与实战

加入社区共建

Taro 邀你加入社区共建

社区共享

Taro 交流社区——让每一次交流都被沉淀

Taro 物料市场——让每一个轮子产生价值

使用案例

Taro 已经投入了我们的生产环境中使用，业界也在广泛地使用 Taro 开发多端应用。

Taro 特性

React 语法风格

Taro 的语法规则基于 React 规范，它采用与 React 一致的组件化思想，组件生命周期与 React 保持一致，同时在书写体验上也尽量与 React 类似，支持使用 JSX 语法，让代码具有更丰富的表现力。

代码示例

code

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

export default class Index extends Component {
  constructor () {
    super(...arguments)
    this.state = {
      title: '首页',
      list: [1, 2, 3]
    }
  }

  componentWillMount () {}

  componentDidMount () {}

  componentWillUpdate (nextProps, nextState) {}

  componentDidUpdate (prevProps, prevState) {}

  shouldComponentUpdate (nextProps, nextState) {
    return true
  }

  add = (e) => {
    // dosth
  }

  render () {
    return (
      <View className='index'>
        <View className='title'>{this.state.title}</View>
        <View className='content'>
          {this.state.list.map(item => {
            return (
              <View className='item'>{item}</View>
            )
          })}
          <Button className='add' onClick={this.add}>添加</Button>
        </View>
      </View>
    )
  }
}

快速开发微信小程序

Taro 立足于微信小程序开发，众所周知小程序的开发体验并不是非常友好，比如小程序中无法使用 npm 来进行第三方库的管理，无法使用一些比较新的 ES 规范等等，针对小程序端的开发弊端，Taro 具有以下的优秀特性：

✅ 支持使用 npm/yarn 安装管理第三方依赖。

✅ 支持使用 ES7/ES8 甚至更加新的 ES 规范，一切都可自行配置。

✅ 支持使用 CSS 预编译器，例如 Sass 等。

✅ 支持使用 Redux 进行状态管理。

✅ 支持使用 Mobx 进行状态管理。

✅ 小程序 API 优化，异步 API Promise 化等等。

支持多端开发转化

Taro 方案的初心就是为了打造一个多端开发的解决方案。目前 Taro 代码可以支持转换到 微信/百度/支付宝/字节跳动小程序 、快应用、 H5 端 以及 移动端（React-Native）。

实战开发指南

快速创建项目

code

# 安装 CLI
npm install -g @tarojs/cli

# 创建项目（React 语法）
taro init my-app

# 创建项目（Vue3 语法）
taro init my-app --template vue3

编译到各端

code

# 微信小程序
taro build --type weapp

# 支付宝小程序
taro build --type alipay

# 抖音小程序
taro build --type tt

# H5
taro build --type h5

# React Native
taro build --type rn

常见问题与解决方案

微信小程序 setData 性能：Taro 在编译时会自动优化 setData，但仍需避免大对象更新。使用 useState 时拆分细粒度状态，避免整个页面的 state 合并更新。
跨端样式差异：不同端的默认样式不同，建议使用 process.env.TARO_ENV 进行条件编译：

code

// 条件编译
{process.env.TARO_ENV === weapp && <View>仅微信显示</View>}

第三方 UI 库集成：
- Vant Weapp：通过 taro-plugin-html 使用，或直接使用 NutUI-Taro（京东官方适配版）
- NutUI：npm install @nutui/nutui-taro 直接支持 Taro
- TDesign：提供 @tarojs/plugin-platform-mini-ci 插件
分包加载：Taro 支持小程序原生分包，在 app.config.ts 中配置：

code

subPackages: [
  { root: pages/sub, pages: [index] }
]

API 差异处理：Taro 提供 Taro.xxx() 统一 API，底层自动适配各端。对于各端独有 API，用 process.env.TARO_ENV 条件分支。

Taro

特性

详细文档

Taro

简介

学习资源

加入社区共建

社区共享

使用案例

Taro 特性

React 语法风格

快速开发微信小程序

支持多端开发转化

更多功能

实战开发指南

快速创建项目

编译到各端

常见问题与解决方案