Vue3 setup 写法最佳实践

最新推荐文章于 2025-10-01 01:44:40 发布

原创最新推荐文章于 2025-10-01 01:44:40 发布 · 782 阅读

1 ·

CC 4.0 BY-SA版权

文章标签：

#javascript #vue.js #前端 #vue #typescript

前端专栏收录该内容

21 篇文章

订阅专栏

文章比较了Vue3中使用SFC的setup方法与组合式API的setup方法在代码组织、类型声明、维护性和性能上的差异。作者认为SFCsetup提供了更清晰的模块化，更简洁的代码和更好的类型推导，因此更利于维护。Vue3官方也推荐使用SFC配合setup语法糖，以减少样板代码并提高性能。

Vue3 setup 写法最佳实践

为什么一定要用SFC而不用组合式API setup()?

两种方式最终都能满足我们搭建组件的需求，但经过实践setup() 形式的组件往往要比SFC 形式的组件多出很多代码且不易维护，下面我会阐述出案例以证实结论

我们先来看组合式 setup()

<template>
  <Select v-model:value="selectValue" />
</template>
<script lang="ts">
import { ref } from 'vue'
import { getBusinessByProject } from '@/api/versionControl/business'
import { KeyItem, RES_CODE } from '@/type'
import { Key } from 'ant-design-vue/es/_util/type'
import { SelectValue } from 'ant-design-vue/lib/select'
 
export default {
  props: {
    value: {
      type: String,
      default: '',
    },
  },
  emits: ['eventBusinessChange'],
  setup() {
    const options = ref<KeyItem[]>([])
    const selectValue = ref<SelectValue>(undefined)
    const loading = ref(false)
 
    const getData = async (key: Key): Promise<void> => {
      try {
        loading.value = true
        const res = await getBusinessByProject({ project: key })
        loading.value = false
        const { status, data } = res || {}
        if (status !== RES_CODE.SUCCESS) return
        options.value = data || []
      } catch (error) {
        loading.value = false
        console.error('getData->', error)
      }
    }
 
    // 返回值会暴露给模板和其他的选项式 API 钩子
    return {
      selectValue,
      getData,
      options,
    }
  },
  mounted() {
    console.log(this.getData) // 0
  },
}
</script>

看完上述代码给我感受:

1.类型声明过于繁琐

2.emits 声明只能声明函数，而不能具体到具体到函数入参与返回值

3.通过return的方式将所有变量和函数都暴露出去了，这样的方式每声明一个变量或者函数模版渲染中所需，都需要暴露出去，如果是一个复杂且状态较多的组件，这样的方式就会变得难以维护

4.return 所暴露出去的函数与变量再父组件往往不需要那么多，对于一个刚入门vue3同学，这样的方式可能会导致大量无用的变量暴露而这些变量其实是无用的，久而久之代码就会变得难以维护…

看完了组合式 setup 我们再来看看SFC setup

<template>
  <Select
    v-model:value="selectValue"
  />
</template>
<script lang="ts" setup>
import { ref } from "vue";
import { Select } from "ant-design-vue";
 
 
interface MyProps {
  data?: ApiQoData;
  needAssert?: boolean;
}
 
const props = withDefaults(defineProps<MyProps>(), {
  needAssert: () => true,
  data: () => {
    return {} as ApiQoData;
  },
});
 
interface MyEmit {
  (e: "eventBusinessChange", key: Key, option: KeyItem): void;
}
 
const emit = defineEmits<MyEmit>();
const options = ref<KeyItem[]>([]);
const selectValue = ref<SelectValue>(undefined);
const loading = ref(false);
 
 
const getData = async (key: Key): Promise<void> => {
  try {
    loading.value = true;
    const res = await api({ project: key });
    loading.value = false;
    const { status, data } = res || {};
    if (status !== RES_CODE.SUCCESS) return;
    options.value = data || [];
  } catch (error) {
    loading.value = false;
    console.error("getData->", error);
  }
};
 
 
defineExpose({
  getData
});
</script>