我们每天写vue3
项目的时候都会使用setup
语法糖,但是你有没有思考过下面几个问题。setup
语法糖经过编译后是什么样子的?为什么在setup
顶层定义的变量可以在template
中可以直接使用?为什么import
一个组件后就可以直接使用,无需使用components
选项来显式注册组件?
要回答上面的问题,我们先来了解一下从一个vue
文件到渲染到浏览器这一过程经历了什么?
我们的vue
代码一般都是写在后缀名为vue的文件上,显然浏览器是不认识vue文件的,浏览器只认识html、css、jss等文件。所以第一步就是通过webpack
或者vite
将一个vue文件编译为一个包含render
函数的js
文件。然后执行render
函数生成虚拟dom,再调用浏览器的dom api
根据虚拟dom生成真实dom挂载到浏览器上。
在javascript
标准中script
标签是不支持setup
属性的,浏览器根本就不认识setup
属性。所以很明显setup
是作用于编译时阶段,也就是从vue文件编译为js文件这一过程。
我们来看一个简单的demo,这个是index.vue
源代码:
{{ title }}
{{ msg }}
这里我们定义了一个名为msg
的ref
响应式变量和非响应式的title
变量,还有import
了child.vue
组件。
这个是child.vue
的源代码
i am child
我们接下来看index.vue
编译后的样子,代码我已经做过了简化:
import { ref } from "vue";
import child from "./child.vue";
const title = "title";
const __sfc__ = {
__name: "index",
setup() {
const msg = ref("hello world!");
if (msg.value) {
const content = "content";
console.log(content);
}
const __returned__ = { title, msg, child };
return __returned__;
},
};
import {
todisplaystring as _todisplaystring,
createelementvnode as _createelementvnode,
createvnode as _createvnode,
fragment as _fragment,
openblock as _openblock,
createelementblock as _createelementblock,
} from "vue";
function render(_ctx, _cache, $props, $setup, $data, $options) {
return (
_openblock(),
_createelementblock(
_fragment,
null,
[
_createelementvnode("h1", null, _todisplaystring($setup.title)),
_createelementvnode(
"h1",
null,
_todisplaystring($setup.msg),
1 /* text */
),
_createvnode($setup["child"]),
],
64 /* stable_fragment */
)
);
}
__sfc__.render = render;
export default __sfc__;
我们可以看到index.vue
编译后的代码中已经没有了template
标签和script
标签,取而代之是render
函数和__sfc__
对象。并且使用__sfc__.render = render
将render
函数挂到__sfc__
对象上,然后将__sfc__
对象export default
出去。
看到这里你应该知道了其实一个vue
组件就是一个普通的js对象,import
一个vue
组件,实际就是import
这个js
对象。这个js对象中包含render
方法和setup
方法。
编译后的setup
方法
我们先来看看这个setup
方法,是不是觉得和我们源代码中的setup
语法糖中的代码很相似?没错,这个setup
方法内的代码就是由setup
语法糖中的代码编译后来的。
setup
语法糖原始代码
setup
编译后的代码
import { ref } from "vue";
import child from "./child.vue";
const title = "title";
const __sfc__ = {
__name: "index",
setup() {
const msg = ref("hello world!");
if (msg.value) {
const content = "content";
console.log(content);
}
const __returned__ = { title, msg, child };
return __returned__;
},
};
经过分析我们发现title
变量由于不是响应式变量,所以编译后title
变量被提到了js
文件的全局变量上面去了。而msg
变量是响应式变量,所以依然还是在setup
方法中。我们再来看看setup
的返回值,返回值是一个对象,对象中包含title
、msg
、child
属性,非setup
顶层中定义的content
变量就不在返回值对象中。
看到这里,可以回答我们前面提的第一个问题。
setup
语法糖经过编译后是什么样子的?
setup
语法糖编译后会变成一个setup
方法,编译后setup
方法中的代码和script
标签中的源代码很相似。方法会返回一个对象,对象由setup
中定义的顶层变量和import
导入的内容组成。
由template
编译后的render
函数
我们先来看看原本template
中的代码:
{{ title }}
{{ msg }}
我们再来看看由template
编译成的render
函数:
import {
todisplaystring as _todisplaystring,
createelementvnode as _createelementvnode,
createvnode as _createvnode,
fragment as _fragment,
openblock as _openblock,
createelementblock as _createelementblock,
} from "vue";
function render(_ctx, _cache, $props, $setup, $data, $options) {
return (
_openblock(),
_createelementblock(
_fragment,
null,
[
_createelementvnode("h1", null, _todisplaystring($setup.title)),
_createelementvnode(
"h1",
null,
_todisplaystring($setup.msg),
1 /* text */
),
_createvnode($setup["child"]),
],
64 /* stable_fragment */
)
);
}
我们这次主要看在render
函数中如何访问setup
中定义的顶层变量title
、msg
,createelementblock
和createelementvnode
等创建虚拟dom的函数不在这篇文章的讨论范围内。你只需要知道createelementvnode("h1", null, _todisplaystring($setup.title))
为创建一个h1
标签的虚拟dom就行了。
在render
函数中我们发现读取title
变量的值是通过$setup.title
读取到的,读取msg
变量的值是通过$setup.msg
读取到的。这个$setup
对象就是调用render
函数时传入的第四个变量,我想你应该猜出来了,这个$setup
对象就是我们前面的setup
方法返回的对象。
那么问题来了,在执行render
函数的时候是如何将setup
方法的返回值作为第四个变量传递给render
函数的呢?我在下一节会一步一步的带你通过debug
源码的方式去搞清楚这个问题,我们带着问题去debug
源码其实非常简单。
有的小伙伴看到这里需要看源码就觉得头大了,别着急,其实很简单,我会一步一步的带着你去debug源码。
首先我们将enable javascript source maps
给取消勾选了,不然在debug源码的时候断点就会走到vue
文件中,而不是走到编译会的js文件中。
然后我们需要在设置里面的ignore list看看node_modules
文件夹是否被忽略。新版谷歌浏览器中会默认排除掉node_modules
文件夹,所以我们需要将这个取消勾选。如果忽略了node_modules
文件夹,那么debug
的时候断点就不会走到node_modules
中vue
的源码中去了。
接下来我们需要在浏览器中找到vue文件编译后的js代码,我们只需要在network
面板中找到这个vue
文件的http
请求,然后在response
下右键选择open in sources panel
,就会自动在sources
面板自动打开对应编译后的js文件代码。
找到编译后的js文件,我们想debug
看看是如何调用render
函数的,所以我们给render函数加一个断点。然后刷新页面,发现代码已经走到了断点的地方。我们再来看看右边的call stack调用栈,发现render
函数是由一个vue
源码中的rendercomponentroot
函数调用的。
点击call stack中的rendercomponentroot
函数就可以跳转到rendercomponentroot
函数的源码,我们发现rendercomponentroot
函数中调用render
函数的代码主要是下面这样的:
function rendercomponentroot(instance) {
const {
props,
data,
setupstate,
// 省略...
} = instance;
render2.call(
thisproxy,
proxytouse,
rendercache,
props,
setupstate,
data,
ctx
)
}
这里我们可以看到前面的$setup
实际就是由setupstate
赋值的,而setupstate
是当前vue实例上面的一个属性。那么setupstate
属性是如何被赋值到vue
实例上面的呢?
我们需要给setup
函数加一个断点,然后刷新页面进入断点。通过分析call stack调用栈,我们发现setup
函数是由vue
中的一个setupstatefulcomponent
函数调用执行的。
点击call stack调用栈中的setupstatefulcomponent
,进入到setupstatefulcomponent
的源码。我们看到setupstatefulcomponent
中的代码主要是这样的:
function setupstatefulcomponent(instance) {
const { setup } = component;
// 省略
const setupresult = callwitherrorhandling(
setup,
instance
);
handlesetupresult(instance, setupresult);
}
setup
函数是component
上面的一个属性,我们将鼠标放到component
上面,看看这个component
是什么东西?
看到这个component
对象中既有render
方法也有setup
方法是不是感觉很熟悉,没错这个component
对象实际就是我们的vue
文件编译后的js对象。
const __sfc__ = {
__name: "index",
setup() {
const msg = ref("hello world!");
if (msg.value) {
const content = "content";
console.log(content);
}
const __returned__ = { title, msg, child };
return __returned__;
},
};
__sfc__.render = render;
从component对象中拿到setup
函数,然后执行setup
函数得到setupresult
对象。然后再调用handlesetupresult(instance, setupresult);
我们再来看看handlesetupresult
函数是什么样的,下面是我简化后的代码:
function handlesetupresult(instance, setupresult) {
if (isfunction(setupresult)) {
// 省略
} else if (isobject(setupresult)) {
instance.setupstate = proxyrefs(setupresult);
}
}
我们的setup
的返回值是一个对象,所以这里会执行instance.setupstate = proxyrefs(setupresult)
,将setup执行会的返回值赋值到vue实例的setupstate属性上。
看到这里我们整个流程已经可以串起来了,首先会执行由setup
语法糖编译后的setup
函数。然后将setup
函数中由顶层变量和import
导入组成的返回值对象赋值给vue
实例的setupstate
属性,然后执行render
函数的时候从vue
实例中取出setupstate
属性也就是setup
的返回值。这样在render
函数也就是template
模版就可以访问到setup
中的顶层变量和import
导入。
现在我们可以回答前面提的另外两个问题了:
为什么在setup
顶层定义的变量可以在template
中可以直接使用?
因为在setup
语法糖顶层定义的变量经过编译后会被加入到setup
函数返回值对象__returned__
中,而非setup
顶层定义的变量不会加入到__returned__
对象中。setup
函数返回值会被塞到vue
实例的setupstate
属性上,执行render
函数的时候会将vue
实例上的setupstate
属性传递给render
函数,所以在render
函数中就可以访问到setup
顶层定义的变量和import
导入。而render
函数实际就是由template
编译得来的,所以说在template
中可以访问到setup
顶层定义的变量和import
导入。。
为什么import
一个组件后就可以直接使用,无需使用components
选项来显式注册组件?
因为在setup
语法糖中import
导入的组件对象经过编译后同样也会被加入到setup
函数返回值对象__returned__
中,同理在template
中也可以访问到setup
的返回值对象,也就可以直接使用这个导入的组件了。
setup
语法糖经过编译后就变成了setup
函数,而setup
函数的返回值是一个对象,这个对象就是由在setup
顶层定义的变量和import
导入组成的。vue
在初始化的时候会执行setup
函数,然后将setup
函数返回值塞到vue
实例的setupstate
属性上。执行render
函数的时候会将vue
实例上的setupstate
属性(也就是setup
函数的返回值)传递给render
函数,所以在render
函数中就可以访问到setup
顶层定义的变量和import
导入。而render
函数实际就是由template
编译得来的,所以说在template
中就可以访问到setup
顶层定义的变量和import
导入。
如果我的文章对你有点帮助,欢迎关注公众号:【欧阳码农】,文章在公众号首发。你的支持就是我创作的最大动力,感谢感谢!