Vue 3 的 setup 函数里，为什么非要写 return？揭秘背后的核心机制

原创已于 2025-07-02 13:03:26 修改 · 5k 阅读

14 ·

CC 4.0 BY-SA版权

文章标签：

#vue.js #前端 #javascript #前端框架 #开发语言

于 2025-06-17 10:48:49 首次发布

Vue3 专栏收录该内容

5 篇文章

订阅专栏

引言：

初学 Vue 3 的 Composition API，很多同学都会被 setup() 函数吸引。它让我们能更灵活地组织组件逻辑，但一个看似简单的 return 语句却常常让人困惑：“我在 setup 里定义的变量和方法，为什么一定要 return 出去？不 return 行不行？” 今天，我们就来深入探讨一下 setup 中 return 的核心作用，理解它为什么是 Vue 3 响应式编程的基石。

一、setup 函数的核心职责

首先，明确 setup() 函数的定位：

替代 Options API： setup 是 Vue 3 Composition API 的入口点，旨在替代 Vue 2 中的 data, methods, computed, watch, lifecycle hooks 等选项。
执行时机： 它在组件实例被创建之前执行，并且在 beforeCreate 和 created 生命周期钩子之前运行。这意味着此时还没有 this (组件实例)。
作用域： 在 setup 函数内部定义的变量、函数、响应式状态，都只是普通的 JavaScript 变量，作用域仅限于 setup 函数内部。

二、关键问题：为什么需要 return？

想象一下，你在 setup 里辛苦定义了一个计数器 count 和一个增加计数的方法 increment：

import { ref } from 'vue';

export default {
  setup() {
    // 1. 定义响应式状态
    const count = ref(0);

    // 2. 定义方法
    function increment() {
      count.value++;
    }

    // 3. 定义计算属性、侦听器等等...
    // ... 其他逻辑 ...

    // 4. ????? 不写 return 会怎样？????
  }
}

如果你省略了 return，会发生什么？

你的模板 (<template>) 将完全无法访问到 count 和 increment！你在模板中尝试 {{ count }} 或 @click="increment" 时，Vue 会告诉你这些属性或方法 is not defined。
组件的其他部分（例如通过 ref 引用的子组件或元素）也无法访问这些状态和方法。

原因很简单：setup 内部的变量和方法是私有的！

封装性： JavaScript 函数内部的变量天然具有局部作用域。count 和 increment 只存在于 setup 函数执行的那个短暂时刻，执行完毕后，如果没有被外部引用，它们通常会被垃圾回收。
模板需要接口： Vue 的模板需要知道它能够绑定哪些数据和方法。这个“接口”就是 setup 函数返回的对象。

三、return 的作用：暴露接口

return 语句的核心作用就是将一个对象暴露给组件的模板 (template) 和其他选项。

import { ref } from 'vue';

export default {
  setup() {
    const count = ref(0);

    function increment() {
      count.value++;
    }

    // ... 其他逻辑 ...

    // 返回一个对象，该对象上的属性和方法
    // 将被“注入”到组件的模板和 `this` 上下文 (在选项 API 中) 中
    return {
      count,   // 暴露响应式数据
      increment // 暴露方法
    };
  }
}

当你 return { count, increment } 时，你是在告诉 Vue：

“嘿 Vue，请把我返回的这个对象里的东西 (count 和 increment)，都挂载到组件实例上。这样，我的模板 (<template>) 就能像以前使用 data 和 methods 一样，直接使用 {{ count }} 和 @click="increment" 了。其他选项（如果需要）也可以通过 this.count 或 this.increment 访问它们。”

本质上，return 建立了 setup 内部私有作用域与组件公共实例之间的桥梁。 没有这座桥，内部状态就无法“流”到模板和组件实例上。

四、return 的对象里应该放什么？

你应该返回所有需要在以下地方使用的数据和方法：

模板 (<template>) 中需要渲染或绑定的事件/属性。
组件的其他选项 (如果混用 Composition API 和 Options API，虽然不推荐，但技术上可行) 中需要通过 this 访问的东西。
通过模板 ref (ref="someRef") 暴露给父组件的东西。

不需要在模板或外部使用的变量或纯内部工具函数，则不需要返回，保持 setup 内部的整洁。

五、不仅仅是模板：响应式系统的关键

return 不仅关乎模板访问，更是 Vue 响应式系统工作的关键环节。

响应式数据 (ref, reactive 等) 必须被返回： 只有被 return 的对象属性，Vue 才能真正将它们与组件实例关联起来，并建立依赖追踪。当这些响应式数据变化时，Vue 才能知道需要更新哪些依赖它们的组件（通常是当前组件的模板）。
如果你在 setup 里创建了一个 ref 但不 return，即使你在 setup 内部修改它，Vue 也无法感知到这个变化需要触发视图更新，因为它没有被注册到组件的响应式系统中。

六、另一种返回值：渲染函数

setup 也可以返回一个渲染函数 (使用 h() 或 JSX)。这在需要完全用 JavaScript 编程方式控制渲染内容时非常有用。

import { h, ref } from 'vue';

export default {
  setup() {
    const count = ref(0);
    // 返回一个渲染函数，替代模板
    return () => h('div', [
      h('p', `Count is: ${count.value}`),
      h('button', { onClick: () => count.value++ }, 'Increment')
    ]);
  }
}

在这种情况下，return 的作用更加直接：它直接告诉 Vue “用我这个函数来渲染组件”。此时，你不再需要 <template> 标签。不过，返回渲染函数是一种更高级的用法，大部分场景我们还是返回对象给模板使用。

七、总结：return 不可或缺

作用域隔离： setup 内部的变量和方法默认是私有的、局部的。
暴露接口： return 是唯一途径，用于将 setup 内部定义的状态 (ref, reactive)、方法、计算属性 (computed)、侦听器 (watch 返回的停止函数) 等暴露给模板和组件实例。
响应式纽带： 对于响应式数据，return 是将其纳入 Vue 响应式依赖追踪系统的必要步骤。没有它，数据变化无法触发视图更新。
桥梁作用： return 的对象是连接 setup 内部逻辑世界与外部模板/组件实例世界的关键桥梁。