如何利用 defineOptions 定义组件名?Vue3.3 及其以上版本的新规范

阿萱君_9894

阿萱君_9894

2026-05-22

955人浏览

原创

defineoptions 是 vue 3.3+ 官方推荐的组件选项声明方式,支持在 中直接配置 name、inheritattrs、emits 等选项,无需额外 script 块或第三方插件,类型安全且 ide 支持完善。

如何利用 defineoptions 定义组件名?vue3.3 及其以上版本的新规范

在 Vue 3.3+ 中,defineOptions 是官方推荐、原生支持的组件选项定义方式,用来替代旧写法中需要额外 <script></script> 块或第三方插件的做法。它简洁、可靠,且不依赖外部工具。

直接在 setup 脚本中调用 defineOptions

只需在 <script setup></script> 内部导入并调用该宏,传入一个配置对象即可:

  • 确保使用 Vue 3.3 或更高版本(如 3.4、3.5)
  • 不需要安装任何插件,也不需修改 vite 配置
  • name 字符串必须是合法的 PascalCase 或 kebab-case,避免空格和特殊符号

示例:

<script setup lang="ts">
import { defineOptions } from 'vue'

defineOptions({
  name: 'UserProfileCard'
})
</script>

name 的实际用途不能忽略

设置组件名不只是为了“看起来整齐”,它直接影响运行时行为:

vue-composition-api-best-practices
vue-composition-api-best-practices

Vue 3 组合式 API 与

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
uni-app快速上手
uni-app快速上手

共0课时 | 0人学习

Vue 教程
Vue 教程

共42课时 | 17.2万人学习

Vue3.x 工具篇--十天技能课堂
Vue3.x 工具篇--十天技能课堂

共26课时 | 2.5万人学习