# vueuse/vueuse `@vueuse/math` > VueUse 的数学函数 **版本：** 14.2.1（2026 年 2 月） **部门：** @vueuse/shared@14.2.1 **标签：** alpha：14.0.0-alpha.3（2025 年 9 月），beta：14.0.0-beta.1（2025 年 9 月），最新：14.2.1（2026 年 2 月） **参考文献：** [文档]() — API 参考、指南 ## API 变更本节记录了特定于版本的 API 更改 - 优先考虑最近的主要/次要版本。 * 已弃用：`and`、`or`、`not` — v14 已弃用，转而使用原始名称 `logicAnd`、`logicOr`、`logicNot` [来源]() * 重大突破：需要 Vue 3.5+ - v14 已移至 Vue 3.5 作为最低版本，启用原生 `useTemplateRef` 和 `MaybeRefOrGetter` [来源]() * 重大突破：仅限 ESM — v13 完全放弃了 CommonJS (CJS) 支持 [来源]() * 新：`useAverage` — 从数组或可变参数中反应性地计算平均值 * 新：`useSum` — 从数组或可变参数中反应性地计算总和 * 新功能：`createProjection` — 在两个数字域之间创建可重用的数字投影仪 * 新功能：`createGenericProjection` — 创建具有任意类型的自定义映射函数的投影仪 * 新功能：`usePrecision` — 选项现在包括用于舍入策略的 `math` 属性（`floor`、`ceil`、`round`） * 新功能：`useClamp` — 当输入是 getter 或只读引用时，返回 `ComputedRef` 而不是 `Ref` * 新功能：`useMath` — 通过键名提供对任何标准 `Math` 方法的反应式访问 * 新：`logicAnd`、`logicOr`、`logicNot` — 支持多个引用的可变反应布尔逻辑 * 新功能：`useMax`、`useMin` — 支持数组和可变参数进行反应式比较 * 新功能：`useAbs`、`useCeil`、`useFloor`、`useRound`、`useTrunc` — 常见数学方法的专用反应式包装器 * 新：`useProjection` — 从一个域到另一个域的反应式数字投影 **还更改了：** `tsdown` 构建系统 v14 · `WatchSource` 类型 v14 · `MaybeRefOrGetter` 本机 v12.8 ## 最佳实践 * 使用带有可变“ref”的“useClamp”来创建自我验证状态。当传递可变引用时，它会返回一个可写的计算值，该计算值会自动限制分配给它的任何值[源]() // 首选：防止无效状态分配 const 值 = useClamp(shallowRef(0), 0, 10) value.value = 15 // 状态保持为 10 * 在`useProjection`中传递域的反应式数组来处理动态缩放。对于输入/输出边界随时间变化的可缩放图表或响应式滑块等 UI 元素来说，这是首选 [来源]() * 在组件逻辑之外使用“createProjection”定义可重用映射器。这确保了应用程序不同部分的一致扩展，并减少了重新定义域的开销[来源]() * 利用聚合可组合项中的剩余参数进行临时计算。 `useSum`、`useAverage`、`useMax` 和 `useMin` 直接接受多个引用，无需创建中间数组引用 // 首选：固定引用集的更清晰的语法 const 总计 = useSum(refA, refB, refC) * 对于数字运算，优先选择“usePrecision”而不是“toFixed”。 `usePrecision` 返回一个 `number`，它可以防止类型强制错误并允许进一步的数学运算，而无需重新解析字符串 [源]() * 在“usePrecision”中使用显式舍入模式来满足特定的 UI 要求。传递 `math` 选项 ('floor' | 'ceil' | 'round') 来控制分页器或进度条中小数值的处理方式 [源代码]() * 将 `logicAnd` 或 `logicOr` 与 `@vueuse/core` 的 `whenever` 结合起来，以获得更清晰的副作用。当基于多个反应标志触发操作时，此模式比复杂的手动“计算”属性更具可读性 * 使用“createGenericProjection”进行非线性域映射。提供自定义投影仪功能来处理数字域之间的对数刻度或自定义缓和过渡[源]() * 使用 `useMath` 从标准 `Math` 方法中反应性地导出值。它会自动包装多个参数，并确保每当任何输入依赖项发生更改时结果都会更新 * 在模板中使用“logicNot”进行反应式布尔反转。在定义可见性或禁用状态时，它比“!ref.value”或手动“计算”包装器更清楚地表达意图

查看数学技能

包含技能