记一次 Vue2 迁移 Vue3 的实践总结
文章来源于@Elab团队，
一、Vue3
Vue3中文文档[1]
2.x 全局 API3.x 实例 API (app) Vue.configapp.config Vue.config.productionTip无 Vue.config.ignoredElementsapp.config.isCustomElement Vue.componentapp.component Vue.directiveapp.directive Vue.mixinapp.mixin Vue.useapp.use Vue.prototypeapp.config.globalProperties
引入此配置选项的目的是支持原生自定义元素，因此数逗衡重命名可以更好地传达它的功能，新选项还需要一个比旧的 string/RegExp 方法提供更多灵活性的函数：
在Vue 2中，Vue.prototype通常用于添加可在所有组件中访问的属性。
Vue 3中的等效项是config.globalProperties。在实例化应用程序内薯做的组件时，将复制这些属性
2.0生命周期3.0生命周期 beforeCreate(组件创建之前)setup() created(组件创建完成)setup() beforeMount(组件挂载之前)onBeforeMount(组件挂载之前) mounted(组件挂载完成)onMounted(组件挂载完成) beforeUpdate(数据更新，虚拟DOM打补丁之前)onBeforeUpdate(数据更新，虚拟DOM打补丁之前) updated(数据更新，虚拟DOM渲染完成)onUpdated(数据更新，虚拟DOM渲染完成) beforeDestroy(组件销毁之前)onBeforeUnmount(组件销毁之前) destroyed(组件销毁之后)onUnmounted(组件销毁之后) activated(被 keep-alive 缓存的组件激活时调用)onActivated(被激活时执行) deactivated(被 keep-alive 缓存的组件停用时调用)onDeactivated(比如从 A 组件，切换到 B 组件，A 组件消失时执行) errorCaptured(当捕获一个来自子孙组件的错误时被调用)onErrorCaptured(当捕获一个来自子孙组件的异常时激活钩子函数)
注意点：
refreactive 入指拆参基本类型引用类型 返回值响应式且可变的 ref 对象响应式代理（Proxy） 访问方式1.ref 对象拥有一个指向内部值的单一属性 .value
2.在dom和setup()的return中会自动解套
3.ref 作为 reactive 对象的 property 被访问或修改时，也将自动解套直接.访问即可
问题 注意点： 因为reactive是组合函数【 对象 】，所以必须始终保持对这个所返回对象的引用以保持响应性，不能解构该对象或者展开
例如：
const { a } = objReactive 或者 return { ...objReactive }
解决方法：
toRefs API
用来提供解决此约束的办法——它将响应式对象的每个 property 都转成了相应的 ref【把对象转成了ref】。
watchEffect 的第一个参数—— effect 函数——自己也有参数：叫 onInvalidate ，也是一个函数，用于清除 effect 产生的副作用。
onInvalidate 被调用的时机很微妙：它只作用于异步函数，并且只有在如下两种情况下才会被调用：
主要作用是指定调度器，即何时运行副作用函数。
优点：很优秀
缺点：他的对手（React），更优秀
虽然好多地方神似React，但是我们也可以从中看出，他们的都源于比较成熟的编程范式——FP（Functional Programming）。
框架只是工具，解决问题才是终极目标；我们还是要把重点放在领悟框架的设计思想上；悟到了，才是真正掌握了解决问题的手段。（抄的）
vue-pdf官方中文文档
vue.js pdf viewer
vue-pdf demo on jsfiddle
TBD: fix the demo
Same browser support as Vue.js 2
since v2.x, the script is exported as esm.
The url of the pdf file. src may also be a string|TypedArray|DocumentInitParameters|PDFDataRangeTransport for more details, see PDFJS.getDocument() .
The page number to display.
The page rotation in degrees, only multiple of 90 are valid.
Document loading progress. Range [0, 1].
Triggered when the document is loaded.
Triggered when a page is loaded.
The total number of pages of the pdf.
Triggered when an error occurred.
Triggered when an internal link is clicked
beware: when the component is destroyed, the object returned by createLoadingTask() become invalid.
Supported options:
img src="" width="16" Franck Freiburger
助你上手Vue3全家桶之Vue3教程
这些内容是博主在学习过程中记录下来的，有一些不重要的点就跳过了，需要时自行查询文档。其实 V2 到 V3 的学习成本不高，熟悉 V2 的话，看完这篇文章就可以上手 V3 。
Vue3官网
在线源码编译地址
setup 是所有 Composition API 的容器，值为一个函数。组件中所用到的数据、方法等等，均要配置在 setup 中，它会在 beforeCreate 之前执行一次，注意： V3 里 this 不再是指向 Vue 实例，访问 this 会是 undefined
尽量不要与V2配置混用
V2 配置（ data 、 methos 、 computed ...）中可以访问到 setup 中的属性、方法。
但在 setup 中不能访问到 V2 配置（ data 、 methods 、 computed ...）。
如果有重名, setup 优先。
setup不能是一个async函数
因为返回值不再 return 的对象, 而是 promise , 模板看不到 return 对象中的属性。（后期也可以返回一个 Promise 实例，但需要 Suspense 和异步组件的配合）
使用 ref 可以创建一个包含响应式数据的引用对象（reference对象，简称ref对象），可以是基本类型、也可以是对象。
语法
定义一个对象类型的响应式数据，内部基于 ES6 的 Proxy 实现，通过代理对象操作源对象内部数据进行操作
语法
与 V2 中 computed 配置功能一致
语法
与 V2 中 watch 配置功能一致，语法有点改动
语法
和 watch 的区别是， watch 既要指明监视的属性，也要指明监视的回调。而 watchEffect ，不用指明监视哪个属性，监视的回调中用到哪个属性，那就监视哪个属性，不用写返回值。
语法
生命周期全都写在 setup 中
创建一个 ref 对象，其 value 值指向另一个对象中的某个属性
语法
将响应式对象转换为普通对象，其中结果对象的每个 property 都是指向原始对象相应 property 的 ref
语法
只处理对象最外层属性的响应式（浅响应式）。适用于：一个对象数据，结构比较深, 但变化时只是外层属性变化
语法
只处理基本数据类型的响应式, 不进行对象的响应式处理。适用于：一个对象数据，后续功能不会修改该对象中的属性，而是生新的对象来替换
语法
让一个响应式数据变为只读的（深只读），应用于不希望数据被修改时
语法
让一个响应式数据变为只读的（浅只读），应用于不希望数据被修改时
语法
将一个由reactive生成的响应式对象转为普通对象，对这个普通对象的所有操作，不会引起页面更新。
语法
标记一个对象，使其永远不会再成为响应式对象，有些值不应被设置为响应式的，竖纯例如复杂的第三方类库等，当渲染具有不可变数据源的大列表时，跳过响应式转换可以提高性能。
语法
创建一个自定义的 ref，并对其依赖项跟租则踪和更新触发进行显式控制。它需要一个工厂函数，该函数接收 track 和 trigger 函数作为参数，并余型咐且应该返回一个带有 get 和 set 的对象。
语法
实现祖与后代组件间通信，父组件有一个 provide 选项来提供数据，后代组件有一个 inject 选项来开始使用这些数据
语法
检查一个值是否为一个 ref 对象
语法
检查一个值是否为一个 isReactive 对象
语法
检查一个对象是否是由 readonly 创建的只读代理
语法
检查对象是否是由 reactive 或 readonly 创建的 proxy
语法
Teleport 提供了一种干净的方法，允许我们控制在 DOM 中哪个父节点下渲染了 HTML ，而不必求助于全局状态或将其拆分为两个组件。
语法
等待异步组件时先渲染一些额外内容，让应用有更好的用户体验
语法
将全局的API，即：Vue.xxx调整到应用实例（app）上
由于 V3 中不在存在 this ，所以 ref 的获取调整了
语法
V3 中在 for 循环元素上绑定 ref 将不再自动创建 $ref 数组。要从单个绑定获取多个 ref ，请将 ref 绑定到一个更灵活的函数上
语法
定义一个组件可以向其父组件触发的事件
使用方式修改
通过事件来监听组件生命周期中的关键阶段
语法
如果看了觉得有帮助的，我是@ 鹏多多11997110103 ，欢迎 点赞 关注 评论；
END
往期文章
个人主页
Vue3 组合式 API 的基础 —— setup
组合式 API 基础 - Vue3中文文档
Setup - Vue3中文文档
setup 是一个组件选项，所以像别的组件选项一样，写在组件导出的对象里。
官方文档如此描述：
setup 选项应该是一个接受 props 和 context 的函数。
此外，我们从 setup 返回的所有内容都将暴露给组件的其余部分 (计算属性、方法、生命周期钩子等等) 以及组件的模板。
个人觉得可以理解为：
正如在一个标准组件中所期望的那样， setup 函数中的 props 是响应式的，当传入新的 prop 时，它将被更新。
context 上下文是一个普通的 JavaScript 对象，它暴露三个组件的 property：
context 是一个普通的 JavaScript 对象，也就是说，它不是响应式的，这意味着你可以安全地对 context 使用 ES6 解构。
attrs 和 slots 是有状态的对象，它们总是会随组件本身的更新而更新。这意味着你应该避免对它们进行解构，并始终以 attrs.x 或 slots.x 的方式引用 property。请注意，与 props 不同， attrs 和 slots 是非响应式的。如果你打算根据 attrs 或 slots 更改应用副作用，那么应该在 onUpdated 生命周期钩子中执行此操作。
如果 setup 返回一个对象，则可以在组件的模板中像传递给 setup 的 props property 一样访问该对象的 property：
setup 还可以返回一个渲染函数，该函数可以直接使用在同一作用域中声明的响应式状态：
新的 setup 组件选项在 创建组件之前 执行，一旦 props 被解析，并充当合成 API 的入口点。
在 setup() 内部， this 不会是该活跃实例的引用，因为 setup() 是在解析其它组件选项之前被调用的掘此睁，所以 setup() 内部的 this 的行为与其它选项中的 this 完全不同。这在和其它选项式 API 一起使用 setup() 时可能会导致混淆。
reactive() 接收一个普通对象然后返回该普通对象的响应式代理。等同于 2.x 的 Vue.observable()
响应式转换是“深层的”：会影响对象内部所有嵌套的属性。基于 ES2015 的 Proxy 实现，返回的代理对象 不等于 原始对象。建议仅使用代理对象而避免依赖原始对象。
接受一个参数值并返回一个响应式且可改变的 ref 对象。ref 对象拥有一个指向内部值的单一属性 .value 。
如果传入 ref 的是一个对象，将调用 reactive 方法进行深层响应转换。
使用响应式 computed API 有两种方式：
传入一个对象（响应式或普通）或 ref，返回一个原始对象的 只读 代理。一个只读的代理是“深层的”，对象内部任何嵌套的属性也都是只读的。
立即执行传入的一个函数，并响应式追踪其依赖，并在其依赖变更时重新运行该函数。
当 watchEffect 在组件的 setup() 函数或生命周期钩子被调用时， 侦听器会被链接到该组件的生命周期，并在组件卸载时自动停止。
在一些情况下，也可以显式调用返回值以停止侦听：
有时副作用函数会执行一些异步的副作用, 这些响应需要在其失效时清除（即完成之前状态已改变了）。所以侦听副作用传入的函数可以接收一个 onInvalidate 函数作入参, 用来注册清理失效时的回调。当以下情况发判岁生时，这个 失效回调 会被触发:
我们之所以是通过传入一个函数去注册失效回调，而不是从回调返回它（如 React useEffect 中的方式），是因为返扒雹回值对于异步错误处理很重要。
在执行数据请求时，副作用函数往往是一个异步函数：
我们知道异步函数都会隐式地返回一个 Promise，但是清理函数必须要在 Promise 被 resolve 之前被注册。另外，Vue 依赖这个返回的 Promise 来自动处理 Promise 链上的潜在错误。
Vue 的响应式系统会缓存副作用函数，并异步地刷新它们，这样可以避免同一个 tick 中多个状态改变导致的不必要的重复调用。在核心的具体实现中, 组件的更新函数也是一个被侦听的副作用。当一个用户定义的副作用函数进入队列时, 会在所有的组件更新后执行：
在这个例子中：
请注意，初始化运行是在组件 mounted 之前执行的。因此，如果你希望在编写副作用函数时访问 DOM（或模板 ref），请在 onMounted 钩子中进行：
如果副作用需要同步或在组件更新之前重新运行，我们可以传递一个拥有 flush 属性的对象作为选项（默认为 'post' ）：
onTrack 和 onTrigger 选项可用于调试一个侦听器的行为。
这两个回调都将接收到一个包含有关所依赖项信息的调试器事件。建议在以下回调中编写 debugger 语句来检查依赖关系：
onTrack 和 onTrigger 仅在开发模式下生效。
watch API 完全等效于 2.x this.$watch （以及 watch 中相应的选项）。 watch 需要侦听特定的数据源，并在回调函数中执行副作用。默认情况是懒执行的，也就是说仅在侦听的源变更时才执行回调。
可以直接导入 onXXX 一族的函数来注册生命周期钩子：
uni-app 项目小程序端支持 vue3 介绍
随着 vue3 的发布， uni-app 也逐步支持 vue3 。
目前小程序平台已支持，h5、App 平台暂不支持。
除支持 vue3 语法特性外， uni-app 特有的生命周期钩子支持 Composition API ，如 onLaunch ， onShow ， onLoad …
下面介绍创建支持 vue3 的 uni-app 项目的流程，以及使用中的一些注意事项。vue3 相关问题请关注vue官方文档 vue3 中文文档。
目前仅支持 cli 方式创建支持 vue3 默认模板项目。
如果你之前没有使用过 vue-cli 方式创建过项目，需要先安装 vue-cli ，若已安装则跳过步骤 1。
步骤 1: 全局安装vue-cli
步骤 2: 用如下的命令创建vue3工程
步骤 3: 创建好工程后，进入对应目录
步骤 4: 将项目跑到微局码虚信平台
需要将编译后的文件 dist/dev/mp-weixin 导入微信开发者工具运行，也可将项目拖入 HbuildX 中运桐燃行，方便运行到各个平台。
欢迎开发者反馈使用该版本遇到的问题，我们将积极收集意见。
后续：
DCloud之所以不支持vue3的h5和app版，主要是因为vue3的组件中很多语法的写法发生变化，这导致uni-app的h5版基础组件库和app版基础组件库的写法与vue3不兼容。
当然除了基础组件，插件市场的所有插件（包括uni ui），都不支持vue3。即便是uni-app已经推出的vue3的小程序模告版，也不支持插件市场的插件。
考虑到生态兼容的重要性，vue官方（尤雨溪）计划2021年4月中下旬推出新版，对vue2的语法做兼容，届时uni-app的h5版和app版将同时推出，并且插件市场的众多插件也将自动适配vue3版的uni-app。
vue 3.0 正式版来了
Vuejs 于2020年9月19日凌晨发布了代号为One Piece的 3.0 版本。以下简称Vue3
跟着官网文档，我们一起来体验下新版的魅力。
Vue3官方文档地址：
首先是测试工具
谷歌插件（需要翻墙）：
火狐插件：
electron桌面应用插件：
出于原型制作或学习目的，您可以将最新版本与以下灶启芦各项配合使用：
使用Vue构建大型应用程序时，建议使用NPM安装方法。它与 Webpack 或 Rollup 等模块 捆绑器 很好地配旁伍对。Vue还提供了用于创作 单一文件组件的 随附工具。
ue提供隐带了一个 官方CLI 用于快速搭建单页应用。
对于Vue 3，您应该使用Vue CLI v4.5，该版本在上npm提供@vue/cli@next。要升级，您需要在@vue/cli全局范围内重新安装最新版本：
然后在Vue项目中运行
在 dist/ NPM软件包的目录中，您会找到许多不同的Vue.js版本。
全局安装脚手架
查看脚手架版本是否在4.5以上（含4.5）
创建项目
此时终端显示如下图
选择第二项 Vue 3 Preview ，等待安装完成。
到此，恭喜你迈入了 Vue 3.0的时代！