普通视图

发现新文章,点击刷新页面。
今天 — 2026年2月3日首页

Vue-常用修饰符

2026年2月2日 21:49

前言

在 Vue 开发中,修饰符(Modifiers)是指令后的一个特殊后缀(以 . 开头),它能以极简的方式帮我们处理事件冒泡、键盘监听以及复杂的双向绑定逻辑。掌握它们,能让你的模板代码既优雅又高效。

一、 事件修饰符:精准控制交互行为

事件修饰符主要用于处理 DOM 事件的细节。

  • .stop:阻止事件冒泡(调用 event.stopPropagation())。
  • .prevent:阻止事件的默认行为(调用 event.preventDefault())。
  • .capture:在捕获模式下触发事件监听器。
  • .self:只有当事件是从触发元素本身触发时才触发回调。
  • .once:事件只触发一次,之后自动移除监听器。
  • .passive:滚动事件的性能优化,告诉浏览器不需要等待 preventDefault

二、 键盘与鼠标修饰符:语义化监听

1. 按键修饰符

在监听键盘事件时,我们经常需要检查特定的按键,例如:<input @keyup.enter="submitForm" type="text" placeholder="按回车提交">

  • .enter:回车键
  • .tab:Tab 键
  • .space:空格键
  • .delete:删除或退格键
  • .up / .down / .left / .right:方向键

2. 鼠标修饰符

用于限制处理程序仅响应特定的鼠标按键。

  • .left:点击鼠标左键触发。
  • .right:点击鼠标右键触发。
  • .middle:点击鼠标中键(滚轮点击)触发。

三、 v-model 修饰符:数据预处理

这些修饰符可以自动处理表单输入的数据格式。

  • .lazy: 将v-model的同步时机设置在change事件之后,一般为在输入框失去焦点时。
  • .number:自动将用户的输入值转为数值类型(内部使用 parseFloat)。
  • .trim:自动过滤用户输入内容的首尾空白字符。

四、 双向绑定修饰符

这是 Vue 2 到 Vue 3 变化最大的部分。

1. Vue 2 时代的 .sync

在 Vue 2 中,.sync 是实现父子组件属性双向绑定的语法糖。

// 使用 .sync 的语法糖
<ChildComponent :title.sync="pageTitle" />
// 在子组件的方法中
this.$emit('update:title', newTitleValue);

2. Vue 3 的统一:v-model:prop

Vue 3 废弃了 .sync,将其功能合并到了 v-model 中。支持在同一个组件上绑定多个 v-model

 // 在父组件中
<ChildComponent v-model:title="pageTitle" />

// 子组件
<script setup>
defineProps(['title']);
const emit = defineEmits(['update:title']);

const updateTitle = (newVal) => {
  emit('update:title', newVal);
};
</script>

3. Vue 3.4+ 的黑科技:defineModel

这是目前 Vue 3 最推荐的写法,极大简化了双向绑定的逻辑代码。

// 父组件
<ChildComponent v-model="inputValue" />

// 子组件
const inputValue = defineModel({
 // inputValue为双向绑定输入框的值
  type: [String],
  // 默认值
  default: ''
})

五、 总结

  1. 交互逻辑优先使用事件修饰符,减少组件内的非业务代码。
  2. 表单处理善用 .trim.number,降低后端校验压力。
  3. 父子通信在 Vue 3 项目中全面拥抱 v-model:prop,如果是新项目(Vue 3.4+),请直接使用 defineModel,它能让你的代码量减少 50% 以上。
昨天 — 2026年2月2日首页

Vue-从内置指令到自定义指令实战

2026年2月2日 12:04

前言

在 Vue 的开发世界里,“指令(Directives)”是连接模板与底层 DOM 的桥梁。除了官方提供的强大内置指令外,Vue 还允许我们根据业务需求自定义指令。本文将带你一次性梳理 Vue 指令体系,并手把手实现一个高频实用的“一键复制”指令。

一、 Vue 内置指令全家桶

在深入自定义指令之前,我们先复习一下这些每天都在用的“老朋友”。内置指令以 v- 开头,是 Vue 预设的特殊属性。

指令 作用描述 核心要点
v-bind 响应式地更新 HTML 属性 简写为 :,如 :src:class
v-on 绑定事件监听器 简写为 @,如 @click
v-model 在表单及组件上创建双向绑定 它是 v-bindv-on 的语法糖
v-if / v-else 根据条件渲染/销毁元素 真正的条件渲染(销毁与重建)
v-show 根据条件切换元素的显示 基于 CSS 的 display: none 切换
v-for 基于源数据多次渲染元素 建议必须绑定唯一的 :key
v-html 更新元素的 innerHTML 注意:易导致 XSS 攻击,慎用
v-once 只渲染元素和组件一次 随后的重新渲染将跳过该部分,用于优化性能

二、 自定义指令:像 v-model 一样强大

1. 核心概念

自定义指令主要用于提高代码复用性。当你发现自己在多个组件中都在操作同一个 DOM 逻辑时,就该考虑将其封装为指令了。

2. 生命周期(钩子函数)

Vue 3 重构了指令钩子,使其与组件生命周期完美对齐:

Vue 3 钩子 Vue 2 对应 执行时机
beforeMount bind 指令第一次绑定到元素时调用
mounted inserted 绑定元素插入父节点时调用
beforeUpdate update 元素所在组件 VNode 更新前
updated componentUpdated 组件及子组件全部更新后调用
unmounted unbind 指令与元素解绑且元素已卸载

3. 钩子函数参数

指令对象的钩子函数中都带有如下参数:

  • el: 绑定的真实 DOM。

  • binding: 对象,包含

    • name:指令名,不包括 v- 前缀。
    • value:指令的绑定值,例如:v-my-directive="1 + 1" 中,绑定值为 2
    • oldValue:指令绑定的前一个值,仅在 ``update/beforeUpdate 和 componentUpdated/updated` 钩子中可用。无论值是否改变都可用。
    • expression:字符串形式的指令表达式。例如 v-my-directive="1 + 1" 中,表达式为 "1 + 1"
    • arg:传给指令的参数,可选。例如 v-my-directive:foo 中,参数为 "foo"
    • modifiers:一个包含修饰符的对象。例如:v-my-directive.foo.bar 中,修饰符对象为 { foo: true, bar: true }
  • vnodeVue 编译生成的虚拟节点

  • oldVnode:上一个虚拟节点,仅在 update/beforeUpdate 和 componentUpdated/updated 钩子中可用


三、 实战:实现“一键复制”指令 v-copy

1. 指令逻辑实现 (/libs/directives/copy.ts)

import { Directive, DirectiveBinding } from 'vue';

export const copyDirective: Directive = {
  mounted(el: HTMLElement, binding: DirectiveBinding) {
    el.style.cursor = 'copy';
    
    // 绑定点击事件
    el.addEventListener('click', () => {
      const textToCopy = binding.value;
      
      if (!textToCopy) {
        console.warn('v-copy: 无复制内容');
        return;
      }

      // 现代浏览器 API
      if (navigator.clipboard && window.isSecureContext) {
        navigator.clipboard.writeText(String(textToCopy))
          .then(() => alert('复制成功!'))
          .catch(() => alert('复制失败'));
      } else {
        // 兼容降级方案
        const textarea = document.createElement('textarea');
        textarea.value = String(textToCopy);
        textarea.style.position = 'fixed';
        textarea.style.left = '-9999px';
        document.body.appendChild(textarea);
        textarea.select();
        try {
          document.execCommand('copy');
          alert('复制成功!');
        } catch (err) {
          console.error('复制失败', err);
        }
        document.body.removeChild(textarea);
      }
    });
  }
};

2. 全局注册与使用

注册 (main.ts):

import { createApp } from 'vue';
import App from './App.vue';
import { copyDirective } from './libs/directives/copy';

const app = createApp(App);
app.directive('copy', copyDirective); // 全局注册
app.mount('#app');

使用:

<template>
  <button v-copy="'这是要复制的内容'">点击复制</button>
</template>

四、 总结

  1. 内置指令覆盖了 90% 的开发场景,应熟练掌握其简写与区别(如 v-if vs v-show)。

  2. 自定义指令是操作 DOM 的最后防线,通过 mountedupdated 钩子可以实现极其灵活的逻辑。

  3. 注意规范:在 Vue 3 + TS 环境下,务必为指令和参数标记类型,以确保代码的健壮性。

Vue-深度解析“组件”与“插件”的区别与底层实现

2026年2月2日 11:38

前言

在 Vue 的生态系统中,“组件(Component)”和“插件(Plugin)”是构建应用的两大基石。虽然它们都承载着逻辑复用的使命,但在设计模式、注册方式和职责边界上却截然不同。本文将带你从底层原理出发,理清二者的核心差异。

一、 核心概念对比

1. 组件 (Component)

组件是 Vue 应用的最小构建单元,通常是一个 .vue 后缀的文件。

  • 本质:可复用的 UI 实例。
  • 职责:封装 HTML 结构、CSS 样式和 TS 交互逻辑。

2. 插件 (Plugin)

插件是用于扩展 Vue 全局功能的工具库。

  • 本质:一个包含 install 方法的对象或函数。
  • 职责:为 Vue 添加全局方法、全局指令、全局组件或注入全局属性(如 vue-routerpinia)。

二、 关键区别总结

特性 组件 (Component) 插件 (Plugin)
功能范围 局部的 UI 渲染与交互 全局的功能扩展
代码形式 .vue 文件(SFC)或渲染函数 暴露 install 方法的 JS/TS 对象
注册方式 app.component() 或局部引入 app.use()
使用场景 按钮、弹窗、列表等 UI 单元 路由管理、状态管理、全局水印指令等

三、 编写形式

1. 编写一个组件

组件的编写我们非常熟悉,通常使用 DefineComponent<script setup>

<template>
  <button class="my-btn"><slot /></button>
</template>

<script setup lang="ts">
// 组件内部逻辑
</script>

2. 编写一个插件 (Vue 3 写法)

在 Vue 3 中,插件的 install 方法第一个参数变为 app (应用实例) ,而不再是 Vue 构造函数。

// myPlugin.ts
import type { App, Plugin } from 'vue';

export const MyPlugin: Plugin = {
  install(app: App, options: any) {
    // 1. 添加全局方法或属性 (通过 config.globalProperties)
    app.config.globalProperties.$myGlobalMethod = () => {
      console.log('执行全局方法');
    };

    // 2. 注册全局指令
    app.directive('my-highlight', {
      mounted(el: HTMLElement, binding) {
        el.style.backgroundColor = binding.value || 'yellow';
      }
    });

    // 3. 全局混入 (慎用)
    app.mixin({
      created() {
        // console.log('插件注入的生命周期');
      }
    });

    // 4. 注册全局组件
    // app.component('GlobalComp', MyComponent);

    // 5. 提供全局数据 (Provide / Inject)
    app.provide('plugin-config', options);
  }
};

四、 注册方式的演进

1. 组件注册

  • 全局注册app.component('MyBtn', MyButton)
  • 局部注册:在父组件中直接 import导入。

2. 插件注册

在 Vue 3 中,使用应用实例的 use 方法。

// main.ts
import { createApp } from 'vue';
import App from './App.vue';
import { MyPlugin } from './plugins/myPlugin';

const app = createApp(App);

// 安装插件,可以传入可选配置
app.use(MyPlugin, {
  debug: true
});

app.mount('#app');

五、 总结与注意事项

  1. Vue 3 的变化:Vue 3 移除了 Vue.prototype,改为使用 app.config.globalProperties 来挂载全局方法。

  2. 职责分离:如果你的代码是为了在页面上显示一段内容,请写成组件;如果你是为了给所有的组件提供某种“超能力”(如统一处理错误、多语言支持),请写成插件

  3. 插件的 install 机制app.use 内部会自动调用插件的 install 方法。如果插件本身就是一个函数,它也会被直接当做 install 函数执行。

Vue-实例从 createApp 到真实 DOM 的挂载全历程

2026年2月2日 11:28

前言

无论是 Vue 2 的 new Vue() 还是 Vue 3 的 createApp(),将组件配置转化为页面上可见的真实 DOM,中间经历了一系列复杂的转换。理解这一过程,不仅能帮我们更好地掌握生命周期,更是理解响应式原理的基础。

一、 挂载过程总览

Vue 实例的挂载过程,本质上是将组件配置转化为虚拟 DOM,最终映射为真实 DOM,并建立响应式双向绑定的过程。


二、 核心挂载步骤详解

1. 初始化阶段 (Initialization)

在 Vue 3 中,通过 createApp 开始。

  • 创建实例:根据传入的根组件配置创建一个应用上下文(vue实例),接着进行数据初始化。

  • 初始化数据:这是最关键的一步。Vue 会依次初始化 Props、Methods、Setup (Vue 3)、Mixins、Data、Computed

    • 校验:Vue 会校验 propsdata 中的变量名是否重复。
    • 响应式绑定:Vue 3 使用 Proxy(Vue 2 使用 Object.defineProperty)对数据进行劫持,建立依赖收集机制。

2. 模板编译阶段 (Template Compile)

这一步将“肉眼可见”的 HTML 模板转化为机器高效执行的 JavaScript 代码。

  • 解析 (Parser) :将 template 字符串解析为 抽象语法树 (AST)
  • 转换 (Transformer) :对 AST 进行静态提升、补丁标记(Patch Flags)等优化。
  • 生成 (Generator) :将 AST 转换成 render 渲染函数 字符串。

3. 生成虚拟 DOM (VNode)

  • Vue 调用生成的 render 函数。
  • render 函数根据Template执行后会返回一个 虚拟 DOM 树 (Virtual DOM) 。它是对真实 DOM 的一种轻量级 JavaScript 对象描述。

4. 挂载与 Patch (Mounting & Patching)

  • 调用 Mount:执行组件的挂载方法。
  • 渲染真实 DOM:渲染器(Renderer)遍历虚拟 DOM 树,递归创建真实的 HTML 元素。
  • 更新页面:将生成的真实 DOM 插入到指定的容器(如 #app)中,替换掉原本的内容。

5. 完成挂载

  • 一旦真实 DOM 渲染完毕,Vue 会触发 mounted(组合式 API 为 onMounted)生命周期钩子,此时开发者可以安全地访问 DOM 节点。

三、 Vue 3 挂载示例

在 Vue 3 项目中,挂载通常发生在 main.ts

// main.ts
import { createApp } from 'vue'
import App from './App.vue'

// 1. 创建应用实例
const app = createApp(App)

// 2. 挂载到指定 DOM 容器
// 挂载过程中会执行编译、数据拦截、生成 VNode 并渲染
app.mount('#app')

四、 总结

  1. AST 与 VNode 的区别

    • AST:是对 HTML 语法的描述,用于代码编译阶段。
    • VNode:是对 DOM 节点的描述,用于运行时渲染和 Diff 算法。
  2. 双向绑定的建立时机:在 data 初始化阶段,Vue 就已经通过响应式 API 拦截了数据。当 render 函数读取数据时,会自动触发依赖收集。

  3. 重新挂载:如果响应式数据发生变化,Vue 不会重新走一遍完整的挂载过程,而是通过 Diff 算法 对比新旧 VNode,仅更新发生变化的真实 DOM 部分。

Vue-路由懒加载与组件懒加载

2026年2月2日 11:14

前言

在构建大型单页应用(SPA)时,JavaScript 包体积(Bundle Size)往往会随着业务增长而膨胀,导致首屏加载缓慢、白屏时间长。懒加载(Lazy Loading) 是解决这一问题的核心方案。其本质是将代码分割成多个小的 chunk,仅在需要时才从服务器下载。

一、 路由懒加载:按需拆分页面

1. 为什么需要路由懒加载?

如果不使用懒加载,所有路由对应的组件都会被打包进同一个 app.js 中。用户访问首页时,浏览器不得不下载整个应用的逻辑,造成严重的性能浪费。

2. 实现方式:ES import()

利用动态导入语法,打包工具(如 Vite 或 Webpack)会自动进行 代码分割(Code Splitting)

// router/index.ts
import { createRouter, createWebHistory, RouteRecordRaw } from 'vue-router';

// 静态导入:会随着主包一起加载,适合首页
import Home from '@/views/Home.vue';

const routes: Array<RouteRecordRaw> = [
  {
    path: '/',
    name: 'Home',
    component: Home
  },
  {
    path: '/about',
    name: 'About',
    // 动态导入:只有访问 /about 路径时,浏览器才会请求该组件对应的 JS 文件
    component: () => import('@/views/About.vue')
  }
];

const router = createRouter({
  history: createWebHistory(),
  routes
});

export default router;

二、 组件懒加载:细粒度控制

有些组件(如弹窗、复杂的图表、第三方重型库)并不需要在页面初次渲染时立即存在。

1. Vue 3 的 defineAsyncComponent

在 Vue 3 中,异步组件必须使用 defineAsyncComponent 进行显式声明。

示例

<template>
  <div>
    <h1>主页面</h1>
    <button @click="showChart = true">加载并显示报表</button>
    
    <AsyncChart v-if="showChart" />
  </div>
</template>

<script setup lang="ts">
import { ref, defineAsyncComponent } from 'vue';

const showChart = ref<boolean>(false);

// 显式定义异步组件
const AsyncChart = defineAsyncComponent(() =>
  import('@/components/BigChart.vue')
);

// 高级配置(可选):带加载状态
const AsyncComponentWithConfig = defineAsyncComponent({
  loader: () => import('./components/MyComponent.vue'),
  loadingComponent: LoadingComponent, // 加载过程中显示的组件
  errorComponent: ErrorComponent,     // 加载失败时显示的组件
  delay: 200,                         // 展示加载组件前的延迟时间
  timeout: 3000                       // 超时时间
});
</script>

2. Vue 2 中直接使用import函数声明异步组件

export default {
  components: {
    // 定义一个异步组件
    'MyLazyComponent': () => import('./components/MyLazyComponent.vue')
  }
}

三、 底层原理与分包策略

1. 打包工具的配合

当你使用 import() 时:

  • Vite/Rollup:会自动将该组件及其依赖提取到一个独立的 .js 文件中。

  • Webpack:会生成一个 chunk,你可以通过“魔法注释”自定义 chunk 的名称:

    const About = () => import(/* webpackChunkName: "about-group" */ './About.vue')
    

四、 总结

  1. 首屏优化:建议首页(Home)使用静态导入,而其他非核心路径、非首屏展示的弹窗/插件全部使用懒加载。

  2. 用户体验:使用异步组件时,建议配合 loadingComponent,避免加载过程中组件区域出现突兀的空白 。

Vue-异步更新机制与 nextTick 的底层执行逻辑

2026年2月2日 10:09

前言

在 Vue 开发中,你是否遇到过“修改了数据但立即获取 DOM 元素,拿到的却是旧值”的情况?这背后涉及 Vue 的异步更新策略。理解 nextTick,就是理解 Vue 如何与浏览器的事件循环(Event Loop)“握手”。

一、 为什么需要 nextTick?

1. 概念定义

nextTick 的核心作用是:在修改数据之后立即使用这个方法,获取更新后的 DOM。因为在vue里面当监听到我们的数据发送变化时,vue会开启一个异步更新队列,视图需要等待队列里面的所有数据变化完成后,再进行统一的更新。

2. Vue 的异步更新策略

Vue 的响应式并不是数据一变,DOM 就立刻变。

  • 当数据发生变化时,Vue 会开启一个异步更新队列
  • 如果同一个 watcher 被多次触发,只会被推入队列一次(去重优化)。
  • 这种机制避免了在一次同步操作中,因为多次修改数据而导致的重复渲染,极大的提高了性能。

二、 核心原理:基于事件循环(Event Loop)

nextTick 的实现逻辑紧密依赖于 JavaScript 的执行机制。

1. 任务调度逻辑

  1. 数据变更:修改响应式数据,Vue 将 DOM 更新任务推入一个异步队列(微任务)。
  2. 注册回调:调用 nextTick(callback),Vue 将该回调推入一个专用的 callbacks 队列。
  3. 执行时机:Vue 优先尝试创建一个微任务(Microtask) ,通常使用 Promise.then。如果环境不支持,则降级为宏任务(如 setTimeout)。
  4. 顺序保证:Vue 内部通过代码执行顺序,确保 DOM 更新任务先于 nextTick 的回调任务 执行。

2. 宏任务与微任务的演进

  • 优先选择Promise.thenMutationObserver(微任务)。
  • 降级选择:如果上述不可用,则降级为宏任务 setImmediatesetTimeout(fn, 0)

三、 使用示例:

1. 在setup中操作 DOM

setup 阶段,组件尚未挂载,DOM 不存在。只有在onMounted中才会创建, 所以无法直接操作,需要通过nextTick()来完成。

<script setup lang="ts">
import { ref, nextTick, onMounted } from 'vue';

const message = ref<string>('初始内容');
const divRef = ref<HTMLElement | null>(null);

// 模拟 setup 阶段(相当于 Vue 2 的 created)
nextTick(() => {
  // 此时 DOM 可能已挂载(取决于具体执行时机),但在 setup 同步代码中无法直接访问
  console.log('setup 中的 nextTick 回调');
});
</script>

2. 数据更新后获取最新的视图信息

这是最常见的场景:例如根据动态内容计算容器高度。

<template>
  <div ref="listRef" class="list">
    <div v-for="item in list" :key="item">{{ item }}</div>
  </div>
  <button @click="addItem">新增条目</button>
</template>

<script setup lang="ts">
import { ref, nextTick } from 'vue';

const list = ref<string[]>(['Item 1', 'Item 2']);
const listRef = ref<HTMLElement | null>(null);

const addItem = async () => {
  list.value.push(`Item ${list.value.length + 1}`);
  
  // ❌ 此时获取的高度是更新前的
  console.log('更新前高度:', listRef.value?.offsetHeight);

  // ✅ 等待 DOM 更新
  await nextTick();

  // 此时可以获取到新增条目后的真实高度
  console.log('更新后高度:', listRef.value?.offsetHeight);
};
</script>

四、 总结:nextTick 的“避坑”锦囊

  • 同步逻辑 vs 异步逻辑:修改数据是同步的,但 DOM 变化是异步的。所有紧随数据修改后的 DOM 操作,都应该放进 nextTick

  • Promise 语法糖:在 Vue 3 中,nextTick 返回一个 Promise。你可以使用 await nextTick() 代替传统的 nextTick(() => { ... }),使代码更具可读性。

  • 性能注意:虽然 nextTick 很好用,但不要滥用。频繁的 DOM 查询依然会带来性能开销,能通过数据驱动(数据绑定)解决的问题,尽量不要手动操作 DOM。

Vue-性能优化利器:Keep-Alive

2026年2月2日 09:35

前言

在后台管理系统或长列表页面中,我们经常遇到这样的需求:从列表进入详情页,返回时希望列表滚动位置、搜索条件都能完美保留。Vue 内置的 <KeepAlive> 正是为此而生。本文将带你从基础用法出发,直击其背后的缓存算法原理。


一、 什么是 Keep-Alive?

<KeepAlive> 是一个内置组件,用于缓存不活动的组件实例,而不是销毁它们。

  • 核心价值:保留组件状态、避免重复渲染 DOM、提升用户体验。
  • 应用场景:表单多步骤切换、列表页返回流、详情页页签切换。

二、 基础实战:结合 Vue Router 实现按需缓存

在 Vue 中,我们通常结合路由的 meta 字段和 <router-view> 的插槽语法来实现。

1. 路由配置

// src/router/index.ts
import { createRouter, createWebHistory, RouteRecordRaw } from 'vue-router';

const routes: Array<RouteRecordRaw> = [
    {
      path: '/your-path',
      name: 'YourComponentName',
      component: () => import('./views/YourComponent.vue'),
      meta: {
        keepAlive: true // 设置需要缓存
      }
    }
];

2. 宿主容器配置

App.vue 或主布局文件中,接着在对应<router-view>的中插入<keep-alive>,并设置include属性来匹配需要缓存的组件

代码段

  // includeComponents为对应的组件文件名称
  <router-view v-slot="{ Component }">
    <KeepAlive :include="includeComponents">
      <component :is="Component" />
    </KeepAlive>
  </router-view>

三、 特有的生命周期钩子

一旦组件被缓存,其正常的销毁流程将被“冻结”,取而代之的是两个专属钩子:

  • activated:组件被激活(初始化渲染或从缓存中恢复)时调用。此时可重新获取数据或重置滚动位置。
  • deactivated:组件被停用(离开当前路由)时调用。此时可清理定时器或取消未完成的请求。

⚠️ 注意:由于组件被缓存,onBeforeUnmountonUnmounted(Vue 2 中的 beforeDestroydestroyed不会被触发。


四、 深度进阶:Keep-Alive 的底层原理

<KeepAlive> 本质上是一个“无渲染组件”,它不渲染多余的 DOM,而是直接操作组件的 VNode。

1. 内存中的 Map 缓存

Keep-Alive 内部维护了一个 cache 对象(Map 结构)和一个 keys 队列(Array 结构):

  • Cache:键是组件的 key,值是组件的 vnode 实例。
  • Keys:记录缓存组件的顺序。

2. 渲染函数逻辑

render 函数执行时:

  1. 获取内部包裹的组件节点。
  2. 查找 cache 中是否存在该组件的实例。
  3. 存在:直接从缓存中获取实例,并更新该 key 在 keys 队列中的位置(移到最后)。
  4. 不存在:将其加入缓存。

3. LRU 缓存策略

如果缓存的组件过多,内存会爆炸吗?不会。 Vue 使用了 LRU (Least Recently Used) 最近最少使用 算法。当缓存数量超过 max 属性设定的阈值时,Vue 会自动销毁 keys 队列中最久没被访问过的那个组件实例。


五、 总结

  1. 组件名称 (name)include 匹配的是组件定义的 name 选项。在 Vue 3 <script setup> 中,如果你没有显式定义 name,Vue 会根据文件名自动生成,建议显式定义以防匹配失效。
  2. 多级嵌套路由:如果你的 <router-view> 层级很深,每一层都需要配置 <KeepAlive> 才能保证整条路径上的状态都被保留。
  3. Key 的重要性:在 <component :is> 上绑定正确的 :key,能有效防止在切换相同组件不同参数(如 /detail/1/detail/2)时出现缓存混乱。
昨天以前首页

Vue-Vue2中的Mixin 混入机制

2026年2月1日 22:23

前言

在开发中,当多个组件拥有相同的逻辑(如分页、导出、权限校验)时,重复编写代码显然不够优雅。Vue 2 提供的 Mixin(混入)正是为了解决逻辑复用而生。本文将从基础用法出发,带你彻底理清 Mixin 的执行机制及其优缺点。

一、 什么是 Mixin?

Mixin 是一种灵活的分发 Vue 组件中可复用功能的方式。它本质上是一个 JS 对象,它将组件的可复用逻辑或者数据提取出来,哪个组件需要用到时,直接将提取的这部分混入到组件内部就行。类似于react和vue3中hooks。


二、 Mixin 的实战用法

1. 定义混入文件

我们通常新建一个文件(如 useUser.ts),文件中包含data、methods、created等属性(和vue文件中script部分一致),导出这个逻辑对象。

// src/mixins/index.ts
export const myMixin = {
  data() {
    return {
      msg: "我是来自 Mixin 的数据",
    };
  },
  created() {
    console.log("执行:Mixin 中的 created 生命周期");
  },
  mounted() {
    console.log("执行:Mixin 中的 mounted 生命周期");
  },
  methods: {
    clickMe(): void {
      console.log("执行:Mixin 中的点击事件");
    },
  },
};

2. 组件内引入(局部混入)

在 Vue 2 的选项式语法中通过 mixins 属性引入。

<script lang="ts">
import { defineComponent } from 'vue';
import { myMixin } from "./mixin/index";

export default defineComponent({
  name: "App",
  mixins: [myMixin], // 注入混入逻辑
  created() {
    // 此时可以正常访问 mixin 中的 msg
    console.log("组件访问 Mixin 数据:", this.msg);
  },
  mounted() {
    console.log("执行:组件自身的 mounted 生命周期");
  }
});
</script>

三、 Mixin 的关键特性与优先级

在使用 Mixin 时,必须清楚其底层合并策略:

  1. 独立性:在多个组件中引入同一个 Mixin,各组件间的数据是不共享的。一个组件改动了 Mixin 里的数据,不会影响到其他组件。

  2. 生命周期合并

    • Mixin 的钩子会与组件自身的钩子合并。
    • 执行顺序:Mixin 的钩子总是先于组件钩子执行。
  3. 冲突处理

    • 如果 Mixin 与组件定义了同名的 data 属性或 methods 方法,组件自身的内容会覆盖 Mixin 的内容
  4. 全局混入

    • main.js 中通过 Vue.mixin() 引入。这会影响之后创建的所有 Vue 实例(不推荐,容易污染全局环境)。

四、 进阶思考:Mixin 的局限性

虽然 Mixin 解决了复用问题,但在大型项目中存在明显的弊端,这也是为什么 Vue 3 转向了 Composition API (Hooks)

  • 命名冲突:多个 Mixin 混入时,容易发生变量名冲突,且难以追溯。
  • 来源不明:在模板中使用一个变量,很难一眼看出它是来自哪个 Mixin,增加了维护成本。
  • 隐式依赖:Mixin 之间无法方便地相互传参或共享状态。

五、 Vue 3 的更优选:组合式函数 (Hooks)

如果你正在使用 Vue 3,建议使用更现代的语法来复用逻辑:

// src/composables/useCount.ts
import { ref, onMounted } from 'vue'

export function useCount() {
  const count = ref<number>(0)
  const msg = ref<string>("我是 Vue 3 Hook 数据")

  const increment = () => count.value++

  onMounted(() => {
    console.log("Hook 中的 mounted")
  })

  return { count, msg, increment }
}

Vue-Computed 与 Watch 深度解读与选型指南

2026年2月1日 19:32

前言

在 Vue 的响应式世界里,computed(计算属性)和 watch(侦听器)是我们处理数据联动最常用的两把利器。虽然它们都能响应数据变化,但背后的设计哲学和应用场景却大相径庭。本文将结合 Vue 3 组合式 API 与 TypeScript,带你理清两者的本质区别。

一、 Computed:智能的“数据加工厂”

computed 的核心在它是一个计算属性。它会根据所依赖的数据动态计算结果,并具备强大的缓存机制。

1. 核心特性

  • 具备缓存性:只有当它依赖的响应式数据发生变化时,才会重新计算。否则,无论多少次访问该属性,都会立即返回上次缓存的结果。
  • 必须有返回值:它必须通过 return 返回计算后的结果。
  • 惰性求值:只有在被读取时才会执行计算。

2. Vue 3 + TS 示例

<script setup lang="ts">
import { ref, computed } from 'vue';

const count = ref<number>(1);

// computedValue1 为计算出的新属性
const computedValue1 = computed<number>(() => {
  console.log('正在执行计算...'); // 只有 count 改变时才会打印
  return count.value + 1;
});
</script>

<template>
  <div>原值: {{ count }} | 计算值: {{ computedValue1 }}</div>
  <button @click="count++">增加</button>
</template>

二、 Watch:敏锐的“数据监控员”

watch 的核心在于响应副作用。当监听的值发生改变时执行特定的回调函数。

1. 核心特性

  • 无缓存性:它不是为了产生新值,而是为了在值变化时执行逻辑。

  • 无返回值:回调函数中通常处理的是异步操作、修改 DOM 或更改其他状态。

  • 配置灵活

    • immediate:设置为 true 时,在初始化时立即执行一次。
    • deep:设置为 true 时,可以深度监听对象内部属性的变化。

2. Vue 3 + TS 示例

<script setup lang="ts">
import { ref, watch } from 'vue';

interface UserInfo {
  name: string;
  age: number;
}

const user = ref<UserInfo>({ name: '张三', age: 25 });

// 监听对象深度变化
watch(
  user,
  (newVal, oldVal) => {
    // 注意:由于是引用类型,newVal 和 oldVal 指向的是同一个对象,只有开启deep: true才能监听到
    console.log('用户信息变了', newVal.age);
  },
  { 
    deep: true,      // 开启深度监听
    immediate: false // 初始化时不立即执行
  }
);
</script>

三、 扩展:Vue 3 中的 WatchEffect

在 Vue 3 中,除了 watch,还有一个更自动化的 watchEffect

  • 区别watchEffect 不需要手动指定监听哪个属性,它会自动收集回调函数中用到的所有响应式变量。
  • 场景:当你需要在一个函数里用到多个响应式数据,且不关心旧值时,watchEffect 代码更简洁。
<script setup lang="ts">
import { ref, watchEffect } from 'vue';

const user = ref({ name: '张三', age: 25 });

// watchEffect 会自动追踪依赖
watchEffect(() => {
  console.log('watchEffect 监听 age:', user.value.age);
  // 自动收集 user.value.age 作为依赖
  // 当 age 变化时会自动执行
});
</script>

四、 深度对比:我该选哪一个?

特性 Computed (计算属性) Watch (侦听器)
主要功能 生成一个新属性(派生状态) 响应数据变化并执行代码(副作用)
缓存 有缓存,依赖不变不计算 无缓存,变化即触发
异步 不支持异步逻辑 支持异步操作(如接口请求)
代码结构 必须有 return 不需要 return
使用场景 格式化数据、多值组合、性能优化 异步数据请求、手动操作 DOM、监听路由变化

Vue-深度拆解 v-if 、 v-for 、 v-show

2026年2月1日 19:11

前言

在 Vue 模板开发中,指令的优先级和渲染机制直接决定了应用的性能。尤其是 v-ifv-for 的“爱恨情仇”,在 Vue 2 和 Vue 3 中经历了完全相反的变革。本文将带你从底层逻辑出发,看透这些指令的本质。

一、 v-if 与 v-for 的优先级之战

1. Vue 2 时代:v-for 称王

在 Vue 2 中,v-for 的优先级高于 v-if

这意味着如果你在同一个元素上同时使用它们,Vue 会先执行循环,再对循环出的每一个项进行条件判断。

  • 后果:即使 v-iffalse,循环依然会完整执行,造成极大的性能浪费。

2. Vue 3 时代:v-if 反超

在 Vue 3 中,v-if 的优先级高于 v-for

此时,如果两者并列,v-if 会先执行。但由于此时循环尚未开始,v-if 无法访问到 v-for 循环中的变量,会导致报错。

3. 最佳实践:永远不要同台竞技

无论哪个版本,永远不要把v-if和v-for同时用在同一个元素上。如果非要一起使用可以通过如下方式:

  • 方案 A:外层包裹 template(推荐)

    如果判断条件与循环项无关,先判断再循环。

    <template v-if="isShow">
      <div v-for="item in items" :key="item.id">{{ item.name }}</div>
    </template>
    
  • 方案 B:使用计算属性 computed(推荐)

    如果需要根据条件过滤列表项,先过滤再循环。

    <script setup lang="ts">
    import { computed } from 'vue';
    const activeItems = computed(() => items.value.filter(item => item.isActive));
    </script>
    
    <template>
      <div v-for="item in activeItems" :key="item.id">{{ item.name }}</div>
    </template>
    

二、 v-if 与 v-show:隐藏背后的玄机

两者都能控制显隐,但“手段”截然不同。

1. 核心区别对照表

特性 v-if v-show
手段 真正的数据驱动,动态添加/删除 DOM 元素 CSS 驱动,切换 display: none 属性
本质 组件的销毁与重建 元素的显示与隐藏
初始渲染 若初始为 false,则完全不渲染 无论真假,都会渲染并保留 DOM
切换消耗 较高(涉及生命周期与 DOM 增删) 较低(仅改变 CSS)
生命周期 切换时触发完整生命周期 不触发生命周期钩子

2. 生命周期触发逻辑(Vue 3 + TS 视角)

由于 v-if 是真实的销毁与重建,它会完整走一遍生命周期。

<script setup lang="ts">
import { onMounted, onUnmounted } from 'vue';

// 假设这是一个被 v-if 控制的子组件
onMounted(() => {
  console.log('子组件已创建并挂载 (v-if 为 true)');
});

onUnmounted(() => {
  console.log('子组件已卸载并销毁 (v-if 为 false)');
});
</script>
  • v-if 切换

    • false -> true:触发 onBeforeMount, onMounted 等。
    • true -> false:触发 onBeforeUnmount, onUnmounted 等。
  • v-show 切换

    • 不会触发上述任何钩子,因为组件实例始终保存在内存中。

三、 总结:如何选型?

  • 选择 v-show:如果元素在页面上频繁切换(如 Tab 标签、折叠面板),v-show 的性能表现更优。
  • 选择 v-if:如果运行条件下改变较少,或者该部分包含大量复杂的子组件,使用 v-if 可以保证初始渲染的轻量化,并在不需要时彻底释放内存。

Vue-组件通信全攻略

2026年1月31日 13:38

前言

在 Vue 开发中,组件通信是构建复杂应用的基础。随着 Vue 3 的普及,通信方式发生了不少变化(如 defineProps 的引入、EventBus 的退场)。本文将对比 Vue 2 与 Vue 3,带你梳理最常用的 5 种通信方案。

一、 父子组件通信:最基础的单向数据流

这是最常用的通信方式,遵循“Props 向下传递,Emit 向上通知”的原则。

1. Vue 2 经典写法

  • 接收:使用 props 选项。
  • 发送:使用 this.$emit

2. Vue 3 + TS 标准写法

在 Vue 3 <script setup> 中,我们使用 definePropsdefineEmits

父组件:Parent.vue

<template>
  <ChildComponent :id="currentId" @childEvent="handleChild" />
</template>

<script setup lang="ts">
import { ref } from 'vue';
import ChildComponent from './Child.vue';

const currentId = ref<string>('001');
const handleChild = (msg: string) => {
  console.log('接收到子组件消息:', msg);
};
</script>

子组件:Child.vue

<script setup lang="ts">
// 使用 TS 类型定义 Props
const props = defineProps<{
  id: string
}>();

// 使用 TS 定义 Emits,具备更好的类型检查
const emit = defineEmits<{
  (e: 'childEvent', args: string): void;
}>();

const sendMessage = () => {
  emit('childEvent', '这是来自子组件的参数');
};
</script>

二、 跨级调用:通过 Ref 访问实例

有时父组件需要直接调用子组件的内部方法。

1. Vue 2 模式

直接通过 this.$refs.childRef.someMethod() 调用。

2. Vue 3 模式(显式暴露)

Vue 3 的组件默认是关闭的。如果父组件想访问子组件的方法,子组件必须使用 defineExpose

子组件:Child.vue

<script setup lang="ts">
const childFunc = () => {
  console.log('子组件方法被调用');
};

// 必须手动暴露,父组件才能访问
defineExpose({
  childFunc
});
</script>

父组件:Parent.vue

<template>
  <Child ref="childRef" />
</template>

<script setup lang="ts">
import { ref, onMounted } from 'vue';
import Child from './Child.vue';

// 这里的类型定义有助于获得代码提示
const childRef = ref<InstanceType<typeof Child> | null>(null);

onMounted(() => {
  childRef.value?.childFunc();
});
</script>

三、 非父子组件通信:事件总线 (EventBus)

1. Vue 2 做法

利用一个新的 Vue 实例作为中央调度器。

import Vue from 'vue';
export const EventBus = new Vue();

// 组件 A 发送
EventBus.$emit('event', data);
// 组件 B 接收
EventBus.$on('event', (data) => { ... });

2. Vue 3 重要变更

Vue 3 官方已移除了 $on$off$once 方法,因此不再支持直接通过 Vue 实例创建 EventBus。

  • 官方推荐方案:使用第三方库 mitttiny-emitter
  • 补充:如果逻辑简单,可以使用 Vue 3 的 provide / inject 实现跨级通信。

provide / inject 示例:

  1. 祖先组件:提供数据 (App.vue)
<template>
  <div class="ancestor">
    <h1>祖先组件</h1>
    <p>当前主题:{{ theme }}</p>
    <Middle />
  </div>
</template>

<script setup lang="ts">
import { ref, provide } from 'vue';
import Middle from './Middle.vue';

// 1. 定义响应式数据
const theme = ref<'light' | 'dark'>('light');

// 2. 定义修改数据的方法(推荐在提供者内部定义,保证数据流向清晰)
const toggleTheme = () => {
  theme.value = theme.value === 'light' ? 'dark' : 'light';
};

// 3. 注入 key 和对应的值/方法
provide('theme', theme);
provide('toggleTheme', toggleTheme);
</script>
  1. 中间组件:无需操作 (Middle.vue)

    中间组件不需要显式接收 theme,直接透传即可

  2. 后代组件:注入并使用 (DeepChild.vue)

<template>
  <div class="descendant">
    <h3>深层子组件</h3>
    <p>接收到的主题:{{ theme }}</p>
    <button @click="toggleTheme">切换主题</button>
  </div>
</template>

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

// 使用 inject 获取,第二个参数为默认值(可选)
const theme = inject('theme');
const toggleTheme = inject<() => void>('toggleTheme');
</script>

四、 集中式状态管理:Vuex 与 Pinia

当应用变得庞大,组件间的关系交织成网时,我们需要一个“单一事实来源”。

  • Vuex:Vue 2 时代的标准。基于 Mutation(同步)和 Action(异步)。

  • Pinia:Vue 3 的官方推荐。

    • 优势:更完美的 TS 支持、没有 Mutation 的繁琐逻辑、极其轻量。
    • 核心stategettersactions

Pinia 示例:

import { defineStore } from 'pinia';

export const useUserStore = defineStore('user', {
  state: () => ({
    name: '张三',
    age: 18
  }),
  actions: {
    updateName(newName: string) {
      this.name = newName;
    }
  }
});

五、 总结与纠错

  1. 安全性建议:在使用 defineExpose 时,尽量只暴露必要的接口,遵循最小暴露原则。
  2. EventBus 警示:Vue 3 开发者请注意,不要再尝试使用 new Vue() 来做事件总线,应当转向 Pinia 或全局状态。

Vue-从 Vue 2 到 Vue 3:生命周期全图鉴与实战指南

2026年1月31日 12:19

前言

生命周期钩子(Lifecycle Hooks)是 Vue 组件从诞生到销毁的全过程记录。掌握生命周期,不仅能让我们在正确的时间点执行逻辑,更是优化性能、排查内存泄露的关键。

一、 生命周期四大阶段

Vue 的生命周期大体可分为:创建、挂载、更新、销毁


二、 Vue 2 vs Vue 3 生命周期对比图

在 Vue 3 组合式 API 中,生命周期钩子需要从 vue 中导入,且命名上增加了 on 前缀。

阶段 Vue 2 (选项式 API) Vue 3 (组合式 API) 备注
创建 beforeCreate / created setup() Vue 3 中 setup 包含了这两个时期
挂载 beforeMount / mounted onBeforeMount / onMounted 常用:操作 DOM、请求接口
更新 beforeUpdate / updated onBeforeUpdate / onUpdated 响应式数据变化时触发
销毁 beforeDestroy / destroyed onBeforeUnmount / onUnmounted 注意:Vue 3 中命名的变更
缓存 activated / deactivated onActivated / onDeactivated 配合 <keep-alive> 使用

三、 详细解析与实战场景

1. 创建阶段 (Creation)

  • Vue 2 (beforeCreate / created)

    • beforeCreate:组件实例刚在内存中被创建,此时还没有初始化好 datamethods 属性。适合插件开发,注入全局变量。
    • created:实例已创建,响应式数据data、methods 已准备好。
      • 场景:最早可发起异步请求的时机。
  • Vue 3 (setup)

    • 在 Vue 3 中,setup 的执行早于 beforeCreate,它是组合式 API 的入口。

2. 挂载阶段 (Mounting)

  • Vue 2 (beforeMount / mounted)
    • beforeMount:此时已经完成了模板的编译,但是还没有挂载到页面中

    • mounted:此时已经将编译好的模板挂载到了页面指定的容器中,可以访问页面中的dom了

      • 场景:dom已创建,可用于获取接口数据和dom元素、访问子组件

  • Vue 3 (onBeforeMount / onMounted)
    • onBeforeMount:模板编译完成,但尚未渲染到 DOM 树中。

    • onMounted:组件已挂载,可以安全地访问 DOM 元素。

      • 场景:获取接口数据、初始化第三方插件(如 ECharts)、访问子组件。

3. 更新阶段 (Updating)

  • Vue 2 (beforeUpdate / updated)

    • beforeUpdate:数据状态更新之前执行,此时 data 中的状态值是最新的,但是界面上显示的数据还是旧的,因为此时还没有开始重新渲染DOM节点。

      • 场景 :此时view层还未更新,可用于获取更新前各种状态。
    • updated:实例更新完毕之后调用,此时 data 中的状态值和界面上显示的数据,都已经完成了更新,界面已经被重新渲染好了。

  • Vue 3 (onBeforeUpdate / onUpdated)

    • onBeforeUpdate:数据已更新,但 DOM 尚未重新渲染。可用于获取更新前的 DOM 状态。
    • onUpdated:DOM 已完成更新。注意:不要在此钩子中修改状态,否则可能导致死循环。

4. 销毁阶段 (Unmounting / Destruction)

  • Vue 2 (beforeDestroy / destroyed)

    • beforeDestroy:实例销毁之前调用。
      • 场景:清理工作,如 清除定时器 (setInterval)、解绑全局事件监听、取消订阅
    • destroyed:Vue 实例销毁后调用。组件彻底从 DOM 中移除,所有的指令和事件监听都会被解除。
  • Vue 3 (onBeforeUnmount / onUnmounted)

    • onBeforeUnmount:实例销毁之前调用。

    • onUnmounted:组件彻底从 DOM 中移除,所有的指令和事件监听都会被解除。

5. 缓存阶段 (Keep-alive)

如果使用了keep-alive缓存组件会新增两个生命周期函数

  • onActivated:组件进入视野,被重新激活时调用。
  • onDeactivated:组件移出视野,进入缓存状态时调用。

四、 Vue 3 + TypeScript 实战演示

以下是使用 script setup 语法编写的生命周期示例:

<template>
  <div ref="container">
    <h2>当前计数:{{ count }}</h2>
    <button @click="count++">增加</button>
  </div>
</template>

<script setup lang="ts">
import { 
  ref, 
  onMounted, 
  onBeforeUpdate, 
  onUpdated, 
  onBeforeUnmount 
} from 'vue'

const count = ref<number>(0)
const container = ref<HTMLElement | null>(null)
let timer: number | null = null

// 挂载阶段
onMounted(() => {
  console.log('Component Mounted. DOM element:', container.value)
  // 模拟一个定时任务
  timer = window.setInterval(() => {
    console.log('Timer running...')
  }, 1000)
})

// 运行阶段
onBeforeUpdate(() => {
  console.log('Data updated, but DOM is not yet re-rendered.')
})

onUpdated(() => {
  console.log('Data updated and DOM re-rendered.')
})

// 销毁阶段
onBeforeUnmount(() => {
  console.log('Cleanup before unmount.')
  if (timer) {
    clearInterval(timer) // 关键:防止内存泄漏
  }
})
</script>

五、 进阶:父子组件生命周期执行顺序

为了清晰起见,我们将顺序拆解为三个主要场景(vue3):

1. 初始挂载阶段

父组件必须等待所有子组件挂载完成后,才能完成自己的挂载逻辑。

  1. setup(开始创建)
  2. onBeforeMount
  3. setup
  4. onBeforeMount
  5. onMounted (子组件渲染完毕,向上通知)
  6. onMounted (父组件接收到信号,宣布整体挂载完毕)

记忆口诀: 父创 -> 子创 -> 子挂 -> 父挂。


2. 更新阶段

当父组件传递给子组件的 props 发生变化时,更新逻辑如下:

  • onBeforeUpdate
  • onBeforeUpdate
  • onUpdated
  • onUpdated

注意: 如果只是父组件自身的私有状态更新,且未影响到子组件,则子组件的更新钩子不会被触发。


3. 销毁阶段

销毁过程同样是“递归”式的,父组件先启动销毁,等子组件销毁完毕后,父组件正式功成身退。

  1. onBeforeUnmount
  2. onBeforeUnmount
  3. unmounted
  4. onUnmounted

六、 Vue 3 + TS 模拟演示

你可以通过以下代码在控制台直接观察执行逻辑。

父组件 Parent.vue

<script setup lang="ts">
import { onMounted, onBeforeMount } from 'vue'
import Child from './Child.vue'

console.log('1. 父 - setup')

onBeforeMount(() => console.log('3. 父 - onBeforeMount'))
onMounted(() => console.log('8. 父 - onMounted'))
</script>

<template>
  <div class="parent">
    <h1>父组件</h1>
    <Child />
  </div>
</template>

子组件 Child.vue

<script setup lang="ts">
import { onMounted, onBeforeMount } from 'vue'

console.log('4. 子 - setup')

onBeforeMount(() => console.log('6. 子 - onBeforeMount'))
onMounted(() => console.log('7. 子 - onMounted'))
</script>

<template>
  <div class="child">子组件内容</div>
</template>

📝 总结与避坑

  1. 接口请求放哪里?

    • 如果子组件的渲染依赖父组件接口返回的数据,请在父组件的 created(Vue 2)或 setup(Vue 3)中请求。
    • 注意:即便你在父组件的 onMounted 发请求,子组件此时也已经渲染完成了。
  2. Refs 访问时机

    • 父组件想通过 ref 访问子组件实例,必须在父组件的 onMounted 之后,因为只有这时子组件才真正挂载完成。
  3. 异步组件

    • 如果子组件是异步组件(如使用 defineAsyncComponent),顺序会发生变化,父组件可能会先执行 onMounted

React-Hooks逻辑复用艺术

2026年1月30日 17:38

前言

在 React 开发中,Hooks 的出现彻底改变了逻辑复用的方式。它让我们能够将复杂的、可复用的逻辑从 UI 组件中抽离,实现真正的“关注点分离”。本文将分享 Hooks 的核心原则,并提供 4 个在真实业务场景中封装的实战案例。

一、 Hooks 核心

1. 概念理解

Hooks 本质上是将组件间共享的逻辑抽离并封装成的特殊函数

2. 使用“红线”:规则与原理

  • 命名规范:必须以 use 开头(如 useChat),这不仅是约定,也是静态检查工具(ESLint)识别 Hook 的依据。
  • 调用位置严禁在循环、条件判断或嵌套函数中调用 Hook

底层原理: React 内部并不是通过“变量名”来记录 Hook 状态的,而是通过链表 。每次渲染时,React 严格依赖 Hook 的调用顺序来查找对应的状态。

注意: 如果在 if 语句中调用 Hook,一旦条件不成立导致某次渲染跳过了该 Hook,整个链表的指针就会错位,导致状态读取异常。

二、 实战:自定义 Hooks 封装

1. AI 场景:消息点赞/点踩逻辑 (useChatEvaluate)

在 AI 对话系统中,消息评价是通用功能。我们需要处理:状态切换(点赞 -> 取消点赞)、单选逻辑、以及异步接口调用。

import React, { useState } from 'react';

// 模拟接口
const public_evaluateMessage = async (params: any) => ({ data: true });

type EvaluateType = "GOOD" | "BAD" | "NONE";

export const useChatEvaluate = (initialType: EvaluateType = "NONE") => {
  const [ratingType, setRatingType] = useState<EvaluateType>(initialType);

  const evaluateMessage = async (contentId: number, type: "GOOD" | "BAD") => {
    let newEvaluateType: EvaluateType;

    // 逻辑:如果点击已选中的类型,则取消选中(NONE);否则切换到新类型
    if (type === "GOOD") {
      newEvaluateType = ratingType === "GOOD" ? "NONE" : "GOOD";
    } else {
      newEvaluateType = ratingType === "BAD" ? "NONE" : "BAD";
    }

    try {
      const res = await public_evaluateMessage({
        contentId,
        ratingType: newEvaluateType,
        content: "",
      });

      if (res.data === true) {
        setRatingType(newEvaluateType);
      }
    } catch (error) {
      console.error("评价失败:", error);
    }
  };

  return { ratingType, evaluateMessage };
};

// 使用示例
const ChatMessage: React.FC<{ id: number }> = ({ id }) => {
  const { ratingType, evaluateMessage } = useChatEvaluate();
  return (
    <button onClick={() => evaluateMessage(id, "GOOD")}>
      {ratingType === "GOOD" ? "👍 已点赞" : "👍 点赞"}
    </button>
  );
};

2. 响应式布局:屏幕尺寸监听 (useMediaSize)

在响应式系统中,封装一个能根据窗口宽度自动切换“设备类型”的 Hook,可以极大地简化响应式开发。

import { useState, useEffect, useMemo } from 'react';

export enum MediaType {
  mobile = 'mobile',
  tablet = 'tablet',
  pc = 'pc',
}

const useMediaSize = (): MediaType => {
  const [width, setWidth] = useState<number>(globalThis.innerWidth);

  useEffect(() => {
    const handleWindowResize = () => setWidth(window.innerWidth);
    window.addEventListener('resize', handleWindowResize);
    // 记得清理事件监听
    return () => window.removeEventListener('resize', handleWindowResize);
  }, []);

  // 使用 useMemo 避免每次渲染都重新运行计算逻辑
  const media = useMemo(() => {
    if (width <= 640) return MediaType.mobile;
    if (width <= 768) return MediaType.tablet;
    return MediaType.pc;
  }, [width]);

  return media;
};

export default useMediaSize;

3. 性能优化:防抖与节流 Hook

A. 防抖 Hook (useDebounce)

常用于搜索框,防止用户快速输入时频繁触发请求。

import { useState, useEffect } from 'react';

function useDebounce<T>(value: T, delay: number): T {
  const [debouncedValue, setDebouncedValue] = useState<T>(value);

  useEffect(() => {
    const handler = setTimeout(() => {
      setDebouncedValue(value);
    }, delay);

    // 关键:在下一次 useEffect 执行前清理上一次的定时器
    return () => clearTimeout(handler);
  }, [value, delay]);

  return debouncedValue;
}

export default useDebounce;

B. 节流 Hook (useThrottle)

常用于滚动加载、窗口缩放,确保在规定时间内只执行一次。

import { useState, useEffect, useRef } from 'react';

function useThrottle<T>(value: T, delay: number): T {
  const [throttledValue, setThrottledValue] = useState<T>(value);
  const lastExecuted = useRef<number>(Date.now());

  useEffect(() => {
    const now = Date.now();
    const remainingTime = delay - (now - lastExecuted.current);

    if (remainingTime <= 0) {
      // 立即执行
      setThrottledValue(value);
      lastExecuted.current = now;
    } else {
      // 设置定时器处理剩余时间
      const timer = setTimeout(() => {
        setThrottledValue(value);
        lastExecuted.current = Date.now();
      }, remainingTime);

      return () => clearTimeout(timer);
    }
  }, [value, delay]);

  return throttledValue;
}

export default useThrottle;

三、 总结:封装自定义 Hook 的心法

  1. 抽离状态而非仅逻辑:如果一段逻辑只涉及纯函数计算,不需要 Hook;只有涉及 useStateuseEffect 等状态管理时,才有必要封装 Hook。
  2. 保持纯净:自定义 Hook 应该只关心逻辑,而不应该直接操作 DOM。
  3. TS 类型保护:利用泛型 <T> 增强 Hook 的兼容性,让它能适配各种数据类型。

React-Scheduler 调度器如何掌控主线程?

2026年1月30日 17:21

前言

在 React 18 的并发时代,Scheduler(调度器) 是实现非阻塞渲染的幕后英雄。它不只是 React 的一个模块,更是一个通用的、高性能的 JavaScript 任务调度库。它不仅让 React 任务可以“插队”,还让“长任务”不再阻塞浏览器 UI 渲染。

一、 核心概念:什么是 Scheduler?

Scheduler 是一个独立的包,它通过与 React 协调过程(Reconciliation)的紧密配合,实现了任务的可中断、可恢复、带优先级执行。

主要职责

  1. 优先级管理:根据任务紧急程度(如用户点击 vs 数据预取)安排执行顺序。
  2. 空闲时间利用:在浏览器每一帧的空闲时间处理不紧急的任务。
  3. 防止主线程阻塞:通过“时间片(Time Slicing)”机制,避免长任务导致页面假死。

二、 Scheduler 的完整调度链路

当一个 setState 触发后,Scheduler 内部会经历以下精密流程:

1. 任务创建与通知

当状态更新时,React 不会立即执行 Render。它首先会创建一个 Update对象来记录这次变更,这个对象中包含这次更新所需的全部信息,例如更新后的状态值,Lane车道模型分配的任务优先级.

2. 优先级排序与队列维护

  • 任务优先级排序: 创建更新后,react会调用scheduleUpdateOnFiber函数通知scheduler调度器有个一个新的任务需要调度,这时scheduler会对该任务确定一个优先级,以及过期时间(优先级越高,过期时间越短,表示越紧急)

  • 队列维护: 接着scheduler会将该任务放入到循环调度中,scheduler对于任务循环调度在内部维护着两个队列,一个是立即执行队列taskQueue和延迟任务队列timeQueue,新任务会根据优先级进入到相应对列

    • timerQueue(延时任务队列) :存放还未到开始时间的任务,按开始时间排序。
    • taskQueue(立即任务队列) :存放已经就绪的任务,按过期时间排序。优先级越高,过期时间越短。

3. 时间片的开启:MessageChannel

将任务放入队列后,scheduler会调用requetHostCallback函数去请求浏览器在合适的时机去执行调度,该函数通过 MessageChannel对象中的port.postMessage 方法创建一个宏任务,浏览器在下一个宏任务时机触发 port.onmessage,并在这宏任务回调中启动 workLoop函数。

补充:Scheduler 会调用 requestHostCallback 请求浏览器调度。它没有选择 setTimeout,而是选择了 MessageChannel

为什么选 MessageChannel? setTimeout(fn, 0) 在浏览器中通常有 4ms 的最小延迟,且属于宏任务中执行时机较晚的。MessageChannelport.postMessage 产生的宏任务执行时机更早,且能更精准地在浏览器渲染帧之间切入。

4. 工作循环:workLoop

  • 在宏任务回调中,调度器会进入 workLoop。它会调用performUnitOfWork函数循环地处理Fiber节点,对比新旧节点的props、state,并从队列中取出最紧急的任务交给 React 执行。

  • workLopp中会包含一个shouldYield函数中断检查函数,用于检查当前时间片是否耗尽以及是否有更高优先级的任务执行,如果有的话则会将主线程控制权交还给浏览器,以保证高优先级任务(如用户输入、动画)能及时响应。


5. 中断与恢复:shouldYield 的魔力

workLoop 执行过程中,每一项单元工作完成后,都会调用 shouldYield() 函数进行“路况检查”。

  • 中断条件:如果当前时间片(通常为 5ms)耗尽,或者检测到有更紧急的用户交互(高优任务插队),shouldYield 返回 true
  • 状态保存:此时 React 会记录当前 workInProgress 树的位置,将控制权交还给浏览器。
  • 任务恢复:Scheduler 会在下一个时间片通过 MessageChannel 再次触发,从记录的位置继续执行,从而实现可恢复。

6. 任务插队

如果在执行一个低优先级任务时,有高优先级任务加入(如用户突然点击按钮),Scheduler会中断当前的低优任务并记录该位置,先执行高优任务。等高优任务完成后,再重新执行或继续之前的低优任务


三、 补充

  1. 执行时机对比MessageChannel 确实在宏任务中非常快,但在某些极其特殊的情况下(如没有 MessageChannel 的旧环境),它会回退到 setTimeout
  2. 饥饿现象防止:如果一个低优先级任务一直被插队怎么办?Scheduler 通过过期时间解决。一旦任务过期,它会从 taskQueue 中被提升为同步任务,强制执行。

React-深度解析Diff 算法中Key 的作用

2026年1月30日 10:33

前言

在 React 开发中,我们经常会在控制台看到 Each child in a list should have a unique "key" prop 的警告。Key 到底是什么?它仅仅是一个为了消除警告的“随机字符串”吗?本文将带你从底层原理出发,看透 Key 在 Diff 算法中的核心价值。

一、 核心概念:什么是 Key?

Key 是 React 用于追踪列表元素身份的唯一辅助标识。它就像是每个 DOM 元素的“身份证号”,让 React 在复杂的更新过程中,能够精准地识别哪些元素被修改、添加或删除。

  • 唯一性:Key 必须在同级元素(Siblings)之间保持唯一。
  • 稳定性:一个元素的 Key 应该在其整个生命周期内保持不变,不建议使用 Math.random() 动态生成。

二、 Key 在 Diff 算法中的作用

React 的 Diff 算法通过 Key 来实现节点复用,这是性能优化的关键:

  1. 匹配新旧元素:当状态更新引发列表变化时,React 会对比新旧两棵虚拟 DOM 树,寻找具有相同 Key 的元素。
  2. 复用现有节点:如果 Key 相同,React 会认为这是同一个组件实例。它会选择复用现有的 DOM 节点和组件状态,仅仅更新发生变化的属性(如 textContent 或 className)。
  3. 减少重绘:由于复用了节点,浏览器不需要执行昂贵的“销毁旧节点 -> 创建新节点”操作,极大提高了更新效率。

三、 实战:Key 的正确用法

在 TSX 中,当我们使用 map 方法渲染列表时,务必在返回的最外层标签上绑定 Key。

import React, { useState } from 'react';

interface Todo {
  id: string; // 唯一标识符
  text: string;
}

const TodoList: React.FC = () => {
  const [todos, setTodos] = useState<Todo[]>([
    { id: '1', text: '学习 React' },
    { id: '2', text: '整理掘金笔记' }
  ]);

  return (
    <ul>
      {/* 这里的 Key 使用数据的唯一 ID */}
      {todos.map((todo) => (
        <li key={todo.id}>
          {todo.text}
          <input type="checkbox" />
        </li>
      ))}
    </ul>
  );
};

export default TodoList;

四、 注意事项:为什么不能盲目使用 Index 作为 Key?

很多新手喜欢直接用数组的 index 作为 Key,但在逆序添加、删除或排序列表时,这会导致严重的性能问题和 UI Bug。

1. 性能降低

假设你在列表头部插入一条数据,原来的 index 0 变成了 index 1。React 会发现 Key 对应的“数据”变了,从而导致原本可以复用的节点全部被迫重新渲染(Re-render)。

2. 状态错位 Bug

如果列表项中包含非受控组件(如 <input />),使用 Index 作为 Key 会导致输入框内容“串位”。因为 React 认为 Key 没变,就复用了旧的 Input 节点及其内部的本地状态。


五、 总结与最佳实践

  • 首选方案:使用来自数据库的唯一 ID(如 UUID 或主键 ID)。
  • 备选方案:如果数据确实是静态的(永远不会排序、过滤、增删),且没有唯一 ID,可以使用 Index。
  • 禁忌:绝对不要在渲染时使用 Math.random()Date.now() 生成 Key。这会导致每次渲染 Key 都不同,React 将无法复用任何节点,造成巨大的性能浪费。

React-深度拆解 React Render 机制

2026年1月30日 09:49

前言

在 React 中,我们常说“渲染(Render)”,但它不仅仅是将 HTML 丢给浏览器那么简单。Render 是一个包含 计算(Reconciliation)提交(Commit) 的复杂过程。理解这一过程,能帮助我们写出更高性能的代码。

一、 Render 的核心三部曲

当 React 决定更新界面时,会经历以下三个关键阶段:

1. 创建虚拟 DOM (Virtual DOM)

JSX 本质上是 React.createElement() 的语法糖。Babel 会将 JSX 编译为 JS 调用,生成一个描述 UI 的对象树(即虚拟 DOM)。

结构定义参考:

// 编译后的逻辑(简化版)
const vDom = {
  type: 'div',
  props: {
    className: 'active',
    children: 'Hello'
  }
};

2. Diff 算法比较 (Reconciliation)

React 并不会盲目替换整个 DOM,而是通过 Diff 算法 对比“新旧两棵虚拟 DOM 树”。

  • 同层比较:只比较同一层级的节点。
  • 类型检查:如果节点类型变了(如 divp),则直接销毁重建。
  • Key 值优化:通过 key 属性识别节点是否只是移动了位置。

3. 渲染真实 DOM (Commit)

在计算出最小差异(Patches)后,React 的渲染器(如 react-dom)会将这些变更同步到真实浏览器环境,触发重绘与回流,使用户看到更新。


二、 触发渲染的四大时机

在函数式组件中,Render 过程可能由以下四种情况触发:

触发场景 描述
首次渲染 应用启动,将组件树完整挂载到页面上。
State 改变 当调用 useStateset 函数或 useReducerdispatch 时。
Props 改变 父组件重新渲染导致传给子组件的属性发生变化。
Context 改变 组件通过 useContext 订阅了上下文,且 Providervalue 发生变更。

三、 实战演示:观测渲染行为

我们可以通过简单的日志输出,来观察不同场景下的渲染行为。

import React, { useState, useContext, createContext } from 'react';

// 创建 Context
const AppContext = createContext(0);

// 子组件
const Child: React.FC<{ count: number }> = ({ count }) => {
  console.log("子组件 Render...");
  return <div>父级传入的 Props: {count}</div>;
};

// 顶层组件
const Home: React.FC = () => {
  const [num, setNum] = useState<number>(0);
  const [other, setOther] = useState<boolean>(false);

  console.log("Home 组件 Render...");

  return (
    <AppContext.Provider value={num}>
      <div style={{ padding: '20px' }}>
        <h2>Render 触发测试</h2>
        
        {/* 1. 修改 State 触发 */}
        <button onClick={() => setNum(prev => prev + 1)}>
          修改 State (Count: {num})
        </button>

        {/* 2. 这里的修改虽然没传给 Child,但父组件重新渲染会导致 Child 也重新渲染 */}
        <button onClick={() => setOther(!other)}>
          无关渲染测试: {String(other)}
        </button>

        {/* 3. Props 改变触发子组件渲染 */}
        <Child count={num} />
      </div>
    </AppContext.Provider>
  );
};

export default Home;
❌
❌