Vue 3需要避免的错误

更新时间：2023年03月15日 16:21:57 作者：chuck

Vue3已经稳定了相当长一段时间了。许多代码库都在生产环境中使用它，其他人最终都将不得不迁移到Vue3。我现在有机会使用它并记录了我的错误，下面这些错误你可能想要避免

使用Reactive声明原始值

数据声明在过去都是非常直接的，但是现在有很多帮助函数供我们使用。目前的规则是：

使用reactive声明Object, Array, Map, Set
使用ref声明String, Number, Boolean

为一个原始值使用reactive会返回一个警告，并且该值不会成为可响应式数据。

/* DOES NOT WORK AS EXPECTED */
<script setup>
import { reactive } from "vue";

const count = reactive(0);
</script>

矛盾的是，另一种方式是可行的。例如，使用ref来声明一个Array会在内部调用reactive。

解构响应式数据

假设你有一个响应式对象拥有count属性，并且有一个按钮来递增count。

<template>
  Counter: {{ state.count }}
  <button @click="add">Increase</button>
</template>

<script>
import { reactive } from "vue";
export default {
  setup() {
    const state = reactive({ count: 0 });

    function add() {
      state.count++;
    }

    return {
      state,
      add,
    };
  },
};
</script>

上述逻辑相当直接，而且如预期的那样工作，但你可能会利用javascript的解构来做以下事情：

/* DOES NOT WORK AS EXPECTED */
<template>
  <div>Counter: {{ count }}</div>
  <button @click="add">Increase</button>
</template>

<script>
import { reactive } from "vue";
export default {
  setup() {
    const state = reactive({ count: 0 });

    function add() {
      state.count++;
    }

    return {
      ...state,
      add,
    };
  },
};
</script>

代码看起来是一样的，而且根据我们以前的经验应该是可行的，但事实上，Vue的响应式跟踪是通过属性访问进行的。这意味着我们不能赋值或解构一个响应式对象，因为与第一个引用的响应式连接已经断开。这就是使用响应式帮助函数的局限性之一。

对.value感到困惑

同样的，使用ref的一个怪异模式可能也很难习惯。

Ref接收一个值，并返回响应式对象。该值在对象内部的.value属性下可用。

const count = ref(0)

console.log(count) // { value: 0 }
console.log(count.value) // 0

count.value++
console.log(count.value) // 1

但是ref在模板文件中使用时会被解包，并且不需要.value。

<script setup>
import { ref } from 'vue'

const count = ref(0)

function increment() {
  count.value++
}
</script>

<template>
  <button @click="increment">
    {{ count }} // no .value needed
  </button>
</template>

但是要小心了！解包只在顶级属性中生效。下面的代码片段会生成[object Object]。

// DON'T DO THIS
<script setup>
import { ref } from 'vue'

const object = { foo: ref(1) }

</script>

<template>
  {{ object.foo + 1 }}  // [object Object]
</template>

正确地使用.value需要时间。尽管某些时候我会忘记如何使用，但是使用它的频率越来越高。

触发事件

自从Vue的最初发布以来，子组件就可以与父组件使用emit来通信。你只需要添加自定义事件监听器来监听一个事件。

// 子组件
this.$emit('my-event')

// 父组件
<my-component @my-event="doSomething" />

现在，emit需要使用defineEmits来进行声明。

<script setup>
const emit = defineEmits(['my-event'])
emit('my-event')
</script>

另一件要记住的事情是，defineEmits和defineProps都不需要被导入。它们在使用script setup时自动可用。

<script setup>
const props = defineProps({
  foo: String
})

const emit = defineEmits(['change', 'delete'])
// setup code
</script>

最后，由于事件现在必须被声明，所以不需要使用.native修饰符，事实上它已经被移除了。

声明附加选项

Options API方法有几个属性在script setup中是不被支持的。

name
inheritAttrs
插件或库所需的自定义选项

解决办法是按照script setupRFC的定义，在同一个组件中设置两个不同的脚本。

<script>
  export default {
    name: 'CustomName',
    inheritAttrs: false,
    customOptions: {}
  }
</script>

<script setup>
  // script setup logic
</script>

使用响应式转换

Reactivity Transform是Vue 3的一个实验性但有争议的功能，目的是简化组件的声明方式。它的想法是利用编译时的转换来自动解包一个ref，并使.value过时。但现在它被放弃了，并将在Vue 3.3中被删除。它仍然可以作为一个包使用，但由于它不是Vue核心的一部分，所以最好不要在它身上投入时间。

定义异步组件

以前的异步组件是通过将其包含在一个函数中来声明的。

const asyncModal = () => import('./Modal.vue')

从 Vue 3开始，异步组件需要使用defineAsyncComponent帮助函数来显式地定义。

import { defineAsyncComponent } from 'vue'

const asyncModal = defineAsyncComponent(() => import('./Modal.vue'))

在模板中使用多余的包裹元素

在Vue 2中，组件模板需要一个单一的根元素，这有时会引入不必要的包裹元素。

<!-- Layout.vue -->
<template>
  <div>
    <header>...</header>
    <main>...</main>
    <footer>...</footer>
  </div>
</template>

现在不再需要这样了，因为现在支持多个根元素。🥳

<!-- Layout.vue -->
<template>
  <header>...</header>
  <main v-bind="$attrs">...</main>
  <footer>...</footer>
</template>

使用错误的生命周期

所有的组件生命周期事件都被重新命名，要么添加on前缀，要么完全改变名称。你可以在下面的图表中查看所有的变化。

不看文档

最后，官方文档已经进行了修改以反映新的API，并包括许多有价值的说明、指南和最佳实践。即使你是一个经验丰富的Vue 2工程师，你也一定会通过阅读文档学到一些新东西。

总结

每个框架都有一个学习曲线，而Vue 3的学习曲线无疑比Vue 2的更陡峭。我仍然不相信两个版本之间的迁移工作是合理的，但组合式API要整洁得多，在你掌握了它之后会感觉很自然。

最后，请记住：

犯错比什么都不做要好得多。

Making mistakes is a lot better than not doing anything.

您可能感兴趣的文章:

Vue3
错误

Vue中使用的EventBus有生命周期
这篇文章主要介绍了Vue中使用的EventBus有生命周期的相关知识，非常不错，具有一定的参考借鉴价值,需要的朋友可以参考下
2018-07-07
Vue-router优化import引入过多导致index文件臃肿问题
这篇文章主要为大家介绍了Vue-router优化import引入过多导致index文件臃肿问题解决,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
2023-08-08
Vue3实现组件拖拽实时预览功能
这篇文章主要介绍了Vue3实现组件拖拽实时预览功能,对于组件拖拽预览,用户可以在含有各种功能组件的列表中,选择需要的组件进行拖拽,需要的朋友可以参考下
2023-12-12
Vue2和Vue3在v-for遍历时ref获取dom节点的区别及说明
这篇文章主要介绍了Vue2和Vue3在v-for遍历时ref获取dom节点的区别及说明，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
2023-03-03
vue3封装echarts组件的实现步骤
这篇文章主要介绍了如何在Vue3中封装一个高效、可复用的ECharts组件TChart,该组件支持响应式图表、空数据展示、事件监听、主题切换和性能优化等功能,文中通过代码介绍的非常详细,需要的朋友可以参考下
2025-01-01
解决使用Vue.js显示数据的时,页面闪现原始代码的问题
下面小编就为大家分享一篇解决使用Vue.js显示数据的时,页面闪现原始代码的问题，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
2018-02-02
如何在在Vue3中使用markdown 编辑器组件
vue3发布正式版不久，生态还没完全发展起来，目前支持vue3的开源markdown编辑器组件基本上也寥寥无几，向大家推荐一个很好用的v-md-editor 组件，组件功能很强大，文档也比较详细。该文章只介绍组件的常用功能，更多高级的功能可以参考官方文档。
2021-05-05
vue 获取及修改store.js里的公共变量实例
今天小编就为大家分享一篇vue 获取及修改store.js里的公共变量实例，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
2019-11-11
一文带你掌握Vue中的路由守卫
路由守卫（Route Guards）是 Vue Router 的一个功能,它允许我们在路由发生之前执行逻辑判断,这篇文章主要为大家介绍了Vue中路由守卫的具体应用,需要的可以了解下
2024-03-03
Vue+Microapp实现微前端的示例详解
这篇文章主要为大家详细介绍了如何实现以vite+vue3+Microapp为主应用，以vue2+element为子应用的微前端，感兴趣的小伙伴快跟随小编一起学习一下吧
2023-06-06