前言:
在 Vue3 日常开发中,条件渲染是使用率最高的指令组合:v-if / v-else-if / v-else / v-show。
看似简单的「显示隐藏」,却是面试高频考点、线上性能 BUG 重灾区:
- 为什么
v-if和v-for不要一起写? v-if和v-show到底怎么选型?v-else为什么偶尔不生效?- 多分支条件渲染为什么容易错乱?
很多同学只会用,不懂底层渲染机制,导致项目出现莫名白屏、DOM 闪烁、性能卡顿、分支匹配错误。
本文分享 Vue3 条件渲染全家桶,包含:语法规则、渲染原理、优先级、区别、坑点、最佳实践。
一、四大条件指令基础用法:
1. v-if /v-else-if/v-else 多分支渲染
v-if 是真正的条件渲染:条件为 false 时,DOM 直接销毁、不存在页面中。
支持多分支连续匹配,自上而下匹配,命中即终止。
基础示例
<template>
<div>
<p v-if="score >= 90">优秀</p>
<p v-else-if="score >= 60">及格</p>
<p v-else">不及格</p>
</div>
</template>
<script setup>
import { ref } from 'vue'
const score = ref(85)
</script>
关键语法硬性规则
v-else-if/v-else必须紧邻前一个分支,中间不能插任何 DOM、注释、标签,否则直接失效。- 多分支从上到下匹配,只会渲染第一个满足条件的节点。
- 初始条件为 false,对应 DOM 不会创建、不会渲染。
2. v-show 显示隐藏
v-show 只是 CSS 切换:通过 display: none 控制显示隐藏,DOM 始终存在。
基础示例
<p v-show="isShow">我是v-show内容</p>
<script setup>
const isShow = ref(false)
</script>
- 隐藏状态:DOM 存在,样式
display: none - 切换开销极低,不涉及 DOM 销毁重建
二、v-if 与 v-show 底层渲染原理对比:
1. v-if 原理(惰性渲染)
- 条件为 false:不创建 VNode、不生成真实 DOM
- 条件由 false → true:重新创建 VNode、渲染 DOM、挂载节点
- 条件由 true → false:销毁 DOM、移除节点、清空实例
本质:DOM 的 创建 / 销毁 切换
2. v-show 原理(惰性加载,高频切换)
- 无论真假,初始一定会渲染 DOM
- 只通过切换 CSS
display属性实现显隐 - 无 DOM 销毁、无重建、无生命周期执行
本质:CSS 样式切换
三、v-if vs v-show 核心区别
| 对比维度 | v-if | v-show |
|---|---|---|
| 控制原理 | 销毁 / 创建 DOM | 切换 display 样式 |
| 初始渲染开销 | 低(false 不渲染) | 高(无论真假必渲染) |
| 切换开销 | 极高(重建 DOM) | 极低(仅改样式) |
| 生命周期 | 切换会触发 mounted /unmounted | 不会触发任何生命周期 |
| 支持模板 | 支持 <template> | 不支持 <template> |
| 惰性渲染 | 支持 | 不支持 |
| 适用场景 | 条件很少变化、一次性判断 | 条件频繁切换(弹窗、Tab 切换) |
一句话选型口诀
- 页面加载判断一次、几乎不变 → 用 v-if
- 频繁显隐、来回切换 → 用 v-show
四、v-else /v-else-if 高频踩坑点:
坑点 1:分支之间插入内容,v-else 直接失效
错误代码:
<!-- ❌ 中间插了div,分支断裂,v-else失效 -->
<p v-if="flag">显示1</p>
<div>我是分割内容</div>
<p v-else">显示2</p>
原因:
v-else 必须紧跟 v-if / v-else-if,中间一旦出现任何节点,分支链直接断开,解析失效。
正确写法:
<!-- ✅ 紧贴连续分支 -->
<p v-if="flag">显示1</p>
<p v-else">显示2</p>
坑点 2:多分支顺序写反,逻辑永远不执行:
<!-- ❌ 逻辑错误:永远进不到优秀分支 -->
<p v-if="score >= 60">及格</p>
<p v-else-if="score >= 90">优秀</p>
自上而下匹配,85 >=60 直接命中,高分分支永远无法执行。
多分支必须 从严苛到宽松 排序!
坑点 3:v-if 和 v-for 混用,性能极差 + 逻辑异常:
Vue2 & Vue3 通用大坑
- Vue2:
v-for优先级 >v-if,先循环再判断,极度浪费性能 - Vue3:
v-if优先级 >v-for,先判断再循环,导致遍历失效
绝对禁止直接混用!
错误示例:
<!-- ❌ 极度不推荐 -->
<div v-for="item in list" v-if="item.age > 18"></div>
正确优化方案:
- 数据层提前过滤(推荐)
const filterList = list.filter(item => item.age > 18)
- 使用
<template v-for>外层循环,内层 v-if 判断
五、v-show 专属坑点:
坑点 1:v-show 不支持 template 标签:
<!-- ❌ 无效 -->
<template v-show="isShow">
<p>内容</p>
</template>
因为 v-show 靠 CSS 控制,template 不会生成真实 DOM,样式无法挂载。
坑点 2:v-show 隐藏后仍占用 JS 资源:
v-show 只是看不见,DOM、组件实例、定时器、请求、监听都在运行。如果是弹窗、复杂表单,长时间隐藏会持续占用内存。
六、v-if 专属高级特性:template 分组渲染:
当需要批量控制一组标签显隐,又不想多一层多余 DOM 嵌套时,使用 <template v-if>:
<template v-if="isShow">
<h1>标题</h1>
<p>段落1</p>
<p>段落2</p>
</template>
特点:
- 不会渲染多余 DOM 节点
- 整体销毁 / 创建
- v-show 不支持此写法
七、最佳实践规范:
1. 优先使用场景:
- 权限控制、页面模块按需渲染、首次加载判断 → v-if
- 弹窗、抽屉、Tab 切换、按钮高频显隐 → v-show
2. 多分支规范:
- 严格保证
if / else-if / else紧贴无间隔 - 条件判断 从高优先级到低优先级 排序
- 复杂多条件优先使用
computed统一管理状态
3. 绝对禁止:
- 禁止 v-if 与 v-for 直接同级混用
- 禁止 v-else 中间插入无关节点
- 禁止高频切换场景使用 v-if