中顶层声明即自动暴露,响应式变量用 ref/reactive/computed 声明后模板直接可用;多状态用 reactive + toRefs 更简洁;私有变量需避开顶层;子组件方法需通过 defineExpose 显式暴露。

不用显式 return,是 <script setup></script> 的默认行为;所谓“避免繁琐导出”,核心其实是理解“哪些要暴露、哪些不暴露”,以及“怎么组织更省事”。关键不在“导出”,而在“顶层声明即自动暴露”这个机制本身。
响应式变量直接声明就能用
只要用 ref、reactive、computed 等 API 创建的变量,在 <script setup></script> 顶层声明,模板里就自动可用:
-
const count = ref(0)→ 模板中直接写{{ count }} -
const userInfo = reactive({ name: '张三', age: 28 })→ 模板中可写{{ userInfo.name }} -
const double = computed(() => count.value * 2)→ 模板中直接用{{ double }}
批量管理状态:用 reactive + toRefs 更清爽
当有多个关联的 UI 状态(比如折叠、显示开关、选中项等),别一个个写 ref,改用 reactive 分组定义,再用 toRefs 解构:
- 先定义一个响应式对象:
const ui = reactive({ isCollapsed: false, showHistory: true, activeMenu: null }) - 再解构暴露:
const { isCollapsed, showHistory, activeMenu } = toRefs(ui) - 解构后的变量仍是响应式,且模板中可直接使用,无需额外 return
私有变量不暴露?藏到非顶层作用域就行
不想让某个变量出现在模板里,就别把它放在顶层。两种稳妥方式:
立即学习“前端免费学习笔记(深入)”;
- 在函数内部定义:
function init() { const _tempData = '仅内部使用'; } - 用立即执行函数包裹:
(() => { const _internalFlag = true })() - 注意:以下划线开头的顶层变量(如
const _secret = 'xxx')仍会暴露,不能靠命名约定实现私有
父组件要调用子组件方法?defineExpose 是唯一出口
模板能用的变量,不等于父组件能通过 ref 访问。如果需要对外提供方法或属性,必须显式声明:
- 子组件中写:
defineExpose({ reset, getValue }) - 其中
reset和getValue必须是顶层已定义的函数或 ref - 这是设计使然,不是缺陷——它强制你明确组件边界,提升可维护性


















