在 Vue 3 开发中,VueUse 是一个非常实用的工具库,它提供了 100+ 个组合式 API 函数,可以大幅提升开发效率。以下将从基础使用、常见场景、常见问题与解决方案三个维度进行详细讲解:
一、VueUse 基础
1. 安装
npm install @vueuse/core
# 或
yarn add @vueuse/core
2. 核心特性
- 组合式 API:所有函数均为
Composable
形式 - 自动卸载:自动清理副作用(如事件监听器、定时器)
- SSR 支持:多数函数支持服务端渲染
- TypeScript:完整的类型定义
二、6 大常见场景与代码示例
1. 状态管理
<script setup>
import { useStorage } from '@vueuse/core'
// 自动同步到 localStorage
const count = useStorage('my-counter', 0)
</script>
<template>
<button @click="count++">{
{ count }}</button>
</template>
2. 浏览器 API 封装
import {
useClipboard } from '@vueuse/core'
const {
copy, text } = useClipboard()
copy('要复制的文本') // 自动处理权限
3. UI 交互增强
<script setup>
import { onClickOutside } from '@vueuse/core'
const