前言

Vue.js 是一款流行的前端框架，其组件设计风格主要分为 Options API（选项式API）和 Composition API（组合式API）两种。在本文中，我们将深入探讨这两种 API 的区别、优缺点，并为你提供在项目中选择合适的设计方式的指导。

1. Options API：传统而直观

1.1 特点

Options API 是 Vue.js 传统的组件设计方式，通过对象来描述组件的各种选项，如 data、methods、computed、watch 等。这种方式在简单组件中非常直观，易于理解。

1.2 优缺点

优点：

结构清晰，适合简单组件。
在小型项目中易于上手。

缺点：

随着组件复杂度增加，同一个功能可能涉及多个选项，导致代码冗长、难以维护。

1.3 示例代码

export default {
  data() {
    return {
      message: 'Hello Vue!',
    };
  },
  methods: {
    greet() {
      alert(this.message);
    },
  },
};

2. Composition API：灵活而高效

2.1 特点

Composition API 是 Vue 3 引入的一种新的组件设计方式，通过函数来组织代码，提供更灵活的组织结构和复用性。这种方式适用于处理复杂组件逻辑。

2.2 优缺点

优点：

更灵活的逻辑组织方式，适用于复杂组件。
代码复用性强，通过函数更容易实现复用。
Typescript 支持更友好。

缺点：

在简单组件中显得繁琐，不如 Options API 直观。

2.3 示例代码


import { ref, onMounted } from 'vue';

export default {
  setup() {
    const message = ref('Hello Vue!');

    const greet = () => {
      alert(message.value);
    };

    onMounted(() => {
      // Do something on component mount
    });

    return {
      message,
      greet,
    };
  },
};

3. 对比与选择

在选择 Vue.js 组件设计方式时，我们需要仔细权衡 Options API 和 Composition API 的特点。以下是它们在关键方面的对比，以及在项目中的选择建议。

3.1 逻辑组织方式

Options API： 使用对象划分不同选项，适合简单组件。这种方式对于初学者和小型项目而言非常直观，但在复杂组件中可能导致选项分散，难以维护。

Composition API： 通过函数组织逻辑，更灵活，适用于复杂组件。函数的结构使得代码更具可读性，特别是当一个功能需要涉及多个选项时，通过函数可以更清晰地组织逻辑。

选择建议： 对于简单组件，Options API 直观易懂；而对于复杂组件，特别是需要更灵活结构的情况下，Composition API 提供更好的组织方式。

3.2 代码复用

Options API： 在复用性上相对较差，通常需要使用 mixin 或混入选项。这可能导致命名冲突和难以维护的问题。

Composition API： 通过函数更容易实现代码的复用。每个函数都可以独立定义一个功能，便于组合和复用，降低了代码的耦合性。

选择建议： 如果你注重代码复用性，尤其是在大型项目中，Composition API 更适合实现可维护和高效的代码。

3.3 响应式数据

Options API： 使用 data 定义响应式数据，通过 this 访问。这是传统的方式，较为直观。

Composition API： 使用 ref、reactive 等 API 定义响应式数据。这样的方式更加灵活，可以更细粒度地控制响应式数据。

选择建议： 对于简单的响应式数据需求，Options API 足够；而对于更复杂的场景，Composition API 提供更多选择。

3.4 生命周期钩子

Options API： 使用生命周期钩子函数，如 created、mounted。这是 Vue 2 中的传统方式。

Composition API： 使用 onMounted、onUpdated 等函数处理生命周期。这种方式更直观，函数名表明了其目的。

选择建议： 如果你更喜欢传统的生命周期钩子方式，可以选择 Options API；而如果你更倾向于直观的函数命名，可以选择 Composition API。

3.5 Typescript 支持

Options API： 在 Vue 2 中对 Typescript 的支持相对较弱，需要额外的配置。

Composition API： Vue 3 对 Typescript 的支持更加友好，可以更轻松地使用 Typescript。

选择建议： 如果你在项目中使用 Typescript，特别是在迁移到 Vue 3 时，Composition API 提供更好的支持。

4 对比实例：

下面是使用Options API和Composition API 实现相同效果的对比分析。

Options API

<script>
import { mapState,mapGetters } from 'vuex';
    export default {
        data(){
            return {
                score: 0
            }
        },
        computed: {
            ...mapState(['answerId']),
            ...mapGetters(['rightAnswer'])
        },
        created(){
            console.log(this.answerId);

            console.log(this.rightAnswer);
            this.calcScore();
        },
        methods:{
            calcScore(){
                let every = 100 / this.answerId.length;
                this.answerId.forEach((item,index) => {
                    if(item === this.rightAnswer[index]){
                        this.score += every;
                    }
                });
            }
        }
    }
</script>

Composition API :

<script>
import { ref, computed, onCreated } from 'vue'
import { useStore } from 'vuex'

    export default {
      setup() {
        const store = useStore()
        const score = ref(0)

        const answerId = computed(() => store.state.answerId)
        const rightAnswer = computed(() => store.getters.rightAnswer)

        const calcScore = () => {
          let every = 100 / answerId.value.length
          answerId.value.forEach((item, index) => {
            if (item === rightAnswer.value[index]) {
              score.value += every
            }
          })
        }

        onCreated(() => {
          console.log(answerId.value)
          console.log(rightAnswer.value)
          calcScore()
        })

        return {
          score,
          answerId,
          rightAnswer,
          calcScore
        }
      }
    }
</script>

主要区别：

数据定义：
- Options API 使用 data 方法来定义组件的响应式数据。
- Composition API 使用 ref 来创建响应式数据。
计算属性：
- Options API 使用 computed 来声明计算属性。
- Composition API 直接在 setup 函数中定义计算属性。
生命周期：
- Options API 使用 created 钩子来执行组件创建时的逻辑。
- Composition API 使用 onMounted 来替代 created 钩子。
方法定义：
- Options API 使用 methods 对象来定义组件的方法。
- Composition API 直接在 setup 函数中定义方法。
导入模块：
- Composition API 需要导入模块 ref 和 onMounted，而 Options API 不需要。

相比较而言，Options API 需要严格地将对应的数据写在其对应的函数后面，而Composition API 则可以直接使用一个setup()函数将所有的数据直接囊括，直接在setup()函数中定义。

值得一提的是，在vue项目中，setup函数通常会简写至script标签内，看起来将会更加简洁高效：

<script setup>
import { ref, computed, onCreated } from 'vue'
import { useStore } from 'vuex'
//余下代码
.......

</script>

结论与建议

在实际项目中，选择 Options API 还是 Composition API 取决于多个因素，包括项目规模、复杂度、团队熟悉度等。综合考虑以上对比和选择建议，你可以更明智地决定在项目中使用哪种组件设计方式。

最终，Vue.js 提供了两种强大的组件设计方式，开发者可以根据具体情况选择最适合项目的 API。无论你选择哪种方式，都能够充分利用 Vue.js 的强大功能，构建出更加可维护和高效的前端应用。

有什么说的不对的地方欢迎在评论区批评指正~

创作不易，如果觉得写的不错，动动发财的小手点个免费的赞吧！谢谢大家！

Vue.js 组件设计：Options API 与 Composition API 对比与选择

原文链接：https://juejin.cn/post/7325495601269473289 作者：雾野千里