Taro 微信小程序云开发云函数上传并部署错误的解决办法

Taro v3.0.5

官方文档是这样的目录结构：

实际目录结构：

引起的错误：

解决办法：

讲 index.ts 修改未 index.js

安装脚手架

初始化如下图，选择Vue3、Less、vue3-NutUI模板：

安装后可能会出现一些告警提示，并提示npm audit ，如下图

如果忽略它，在run dev时会报错，并且报错提示还比较难懂。

这个报错的原因是taro的版本不一致所引起，需要运行 npm audit fix 进行修复，修复后再运行就正常了。

3.1 引入组件

3.2 页面使用组件

NUTUI几个有意思的组件，如table, card,fixednav

4.1 init初始化

app.js中初始化，输入云开发ID

4.2 编写云函数（另说明）

4.3调用云函数

用于多端展示，taro应该是有其之长处的。如果仅是用于微信小程序开发，不如用微信开发者工具。

小程序的设计并没有完全遵循 Web 规范，导致小程序生态和传统 Web 开发生态之间的割裂，海量优秀的 Web 物料并不能直接用于小程序开发。因而 Taro 在相当一段时间内生态都相对薄弱，UI 框架选择不多的问题更是深深困扰着开发者。

另一方面，业界有着存量的 H5 应用，中短期内 H5 应用适配到小程序端的需要还会存在。我们希望能减少 H5 应用迁移到小程序端的成本，甚至能够直接运行在小程序端。

Taro 团队一直在思考如何最大限度地在小程序环境中复用 Web 生态，直到 Taro 3.0 诞生后，这种想法有了落地的可能。下文将介绍基于 Taro 3.0 实现 H5 同构的思路与问题，以及我们尝试适配了三大移动端 UI 框架 WEUI 、 Ant Design Mobile 、 VantUI 的实验结果。

Taro 3.0 是一款重运行时的跨端框架，它通过模拟实现浏览器的 BOM 和 DOM API 实现了对 React、Vue 等 Web 开发框架的兼容。

既然已经有了浏览器环境的 BOM 和 DOM API，Taro 应用和 Web 应用之间的鸿沟在于小程序组件和 HTML 标签之间的差异。

Taro3 的渲染数据流如下：

前端框架 ->Taro DOM ->小程序 data

HTML 标签和小程序组件的标签名、属性、事件是有差异的，而前端框架无需感知这些差异。

因此前端框架适配层、Taro DOM 层不需要改动，只要在 Taro DOM 序列化为小程序 data 这一步作映射即可。

HTML 标签相对小程序组件封装程度更低、功能更简单，可以看作是小程序组件的子集。因此可以按一定的规则，把 HTML 标签映射为小程序组件，如：

完整的标签名映射规则请看： RFC 附录一

如果 HTML 标签的属性能在对应小程序组件的属性上找到对应，则进行映射，如：

完整的属性名映射规则请看： RFC 附录二

把 HTML 特有的事件在小程序端找到相似的事件进行映射，如：

完整的事件映射规则请看： RFC 附录三

前文介绍了我们会把 HTML 标签映射为小程序组件，但是 H5 应用中使用到的 CSS 标签选择器就会失效。

因此 Taro 使用了类名去进行模拟：

Taro 提供两种内置的浏览器默认样式，可以直接引入生效：

理想很美好，但现实却略显骨感。即使 Taro 能实现 BOM、DOM API，支持使用 HTML 标签等，同构方案还是存在着一些框架层面抹平不了的差异。以下列举出若干主要限制：

在 H5 中我们可以调用 DOM API 同步获取元素的尺寸：

但是在小程序中，获取元素尺寸的 API 是异步的：

因此不能兼容那些使用了同步 DOM API 去获取元素尺寸的组件。

<canvas>、 <video>、 <audio> 等标签在 H5 端可以直接调用 HTMLElement 上的方法：

但是在 Taro 中，要调用组件上的原生方法，必须先创建对应的 Context ：

部分样式或 CSS 选择器在小程序中不支持，如：

首先需要安装 v3.3 的 CLI 工具：

然后进入项目，把 package.json 文件中 taro 相关依赖的版本修改为 ^3.3.0-alpha.2 ，再重新安装依赖（建议先把 node_modules 文件夹删除）。

为了节省项目空间，同构功能是可选的，以 Taro 插件的形式提供。

首先开发者需要安装插件 @tarojs/plugin-html ：

然后配置使用此插件：

为了验证同构功能的可用性和效果，我们对 CSS 样式库 WEUI 、React 组件库 Antd Design Mobile 、Vue2 组件库 VantUI 的所有组件进行了测试。

测试效果比较理想，甚至稍微超出我们的预期，配合各组件库自身的按需加载能力，能以小巧的体积使用丰富的组件，相信各位开发者会喜欢这个功能。

仓库地址： taro-weui

WEUI 是一个 CSS 的样式库，与框架无关，兼容性比较高，大部分组件能直接使用。

仓库地址： taro-antd-mobile

能直接兼容使用的组件大概为 80%，主要问题在于：

仓库地址： taro-vant

VantUI 的组件十分丰富，能直接兼容使用的组件大概为 70%。部分开发者会在 Taro 中配合使用 Vant Weapp，但 Vant Weapp 只能运行在微信小程序，因此对 VantUI 的直接适配是一个很好的补充。

适配过程主要遇到的问题有：

同构方案还在持续优化中，部分实现还没有最终定稿。欢迎各位开发者到我们的论坛下留言，提出您的宝贵意见～： 同构方案 RFC 。

欢迎关注凹凸实验室

---