Taro · 京东 O2Team 开源的开放式跨端跨框架解决方案｜一套代码构建小程序/Web/App 应用的开发部署全指南
项目仓库： https://github.com/NervJS/taro
开源协议：MIT（Copyright O2Team） · 定位：用 React/Vue/Nerv
等框架一套代码多端运行 · 官方文档：docs.taro.zone ·
CLI：@tarojs/cli · 支持端：微信/京东/百度/支付宝/字节/QQ
小程序、H5、React Native
1 项目简介
Taro（读作 “tɑ:roʊ”，取自奥特曼）是京东 O2Team 开源的开放式跨端跨框架解决方案：支持用 React / Vue / Nerv 等框架开发微信、京东、百度、支付宝、字节跳动、QQ 小程序以及 H5、React Native 等应用。当业务要求同一套代码在多个端运行时，Taro 让你只写一套代码即可适配多端，避免为每个端单独维护代码。
1.1 核心信息一览
| 项目项 | 内容 |
|---|---|
| 项目名称 | Taro |
| 仓库地址 | github.com/NervJS/taro |
| 项目定位 | 跨端跨框架多端应用开发框架 |
| 开源协议 | MIT（O2Team） |
| 支持框架 | React / Vue / Nerv |
| 支持端 | 微信/京东/百度/支付宝/字节/QQ 小程序、H5、React Native |
| CLI | @tarojs/cli |
| 官方文档 | docs.taro.zone |
1.2 适用场景
- 一套代码同时发布到多个小程序平台与 H5/App。
- 团队想用 React/Vue 技术栈开发小程序，而非各小程序厂商私有语法。
- 已有 Web 业务想低成本覆盖多端。
1.3 能力边界（官方口径）
- Taro 1/2 迁移到 Taro 3 需阅读《Taro 版本升级权威指南》。
- UI 生态：taro-ui、NutUI、taroify、@antmjs/vantui、Tard、duxui 等。
2 功能特性
- 一套代码多端运行：小程序 / H5 / React Native。
- 跨框架：React、Vue、Nerv。
- 丰富 UI 生态：官方与社区多套多端 UI 组件库。
- 物料市场：taro-ext.jd.com 物料共享。
- 活跃工程化：自带 CLI、构建、类型与测试。
3 官方界面预览
Taro 是开发框架，无运行时界面；产出为各端原生小程序 / H5 / App 应用。
4 官方跳转链接汇总
| 类别 | 链接 | 说明 |
|---|---|---|
| 仓库主页 | https://github.com/NervJS/taro | 源码 |
| 官方文档 | docs.taro.zone/docs/guide | 5 分钟上手 |
| awesome-taro | github.com/NervJS/awesome-taro | 资源合集 |
| taro-ui | github.com/NervJS/taro-ui | 官方多端 UI 库 |
| 物料市场 | taro-ext.jd.com | 物料共享 |
| npm | @tarojs/cli | CLI |
5 前置要求与服务器配置
5.1 软件前提
- Node.js 与 npm（运行 Taro CLI）。
- 各小程序开发者工具（微信开发者工具等）用于预览与上传。
5.2 硬件建议
- 普通开发机即可；Taro 是构建工具，无服务器运行时。
5.3 端口与资源
- 开发时 H5 预览有本地 dev server 端口；无生产服务器需求。
6 方式一：CLI 初始化项目（推荐）
# 安装 CLI
npm install -g @tarojs/cli
# 初始化项目
taro init myApp
# 以微信小程序为例，编译到微信小程序目录后用微信开发者工具打开
npm run dev:weapp7 方式二：选用 UI 库与模板
在项目中按需引入 taro-ui / NutUI / taroify 等 UI 库；参考 awesome-taro 选择模板与组件。
8 配置项说明
- 项目配置
config/index.js与各端编译配置；按官方文档调整输出端与代理。
9 常用运维命令
taro init初始化；npm run dev:<端>开发；npm run build:<端>产出生产包。
10 常见故障排查
- 版本迁移问题：读《Taro 版本升级权威指南》。
- 端差异：查官方文档与 awesome-taro。
11 风险与合规说明
- 许可证：MIT。
- 本文整理自官方 README，命令以官方文档最新说明为准；不包含 star 数等动态数据。