Vue Hooks Plus 2.4.0 版本 useRequest 自动依赖刷新功能弃用说明

在 Vue Hooks Plus 项目的 2.4.0 版本中，开发团队决定弃用 useRequest 钩子的自动依赖刷新功能。这一变更源于该功能在实际使用中暴露出的性能问题和稳定性隐患。

背景与问题

自动依赖刷新功能原本设计用于自动检测依赖项变化并触发请求重新执行。虽然这一功能在表面上提供了便利，但经过长期实践发现：

1. 性能瓶颈：自动依赖收集机制在复杂组件中会产生不必要的性能开销
2. 稳定性问题：依赖项的自动识别在某些边界情况下不够可靠
3. 不可预测性：开发者难以精确控制何时会触发请求刷新

解决方案

项目团队建议开发者转而采用显式声明依赖的方式。这种方式虽然需要开发者手动维护依赖项，但带来了以下优势：

• 更精确的控制请求触发时机
• 减少不必要的请求
• 提高代码可预测性
• 避免潜在的性能问题

迁移指南

对于正在使用自动依赖刷新功能的项目，迁移到显式声明模式非常简单：

// 旧用法（将被弃用）
const { data } = useRequest(service, {
  refreshDeps: true // 自动依赖刷新
})

// 新用法（推荐）
const { data } = useRequest(service, {
  refreshDeps: [dep1, dep2] // 显式声明依赖
})

最佳实践

1. 明确依赖项：仔细分析服务函数实际依赖的外部变量
2. 最小化依赖：只包含真正会影响请求结果的变量
3. 使用计算属性：对于复杂依赖，可以先使用计算属性处理
4. 性能优化：对于高频变化的依赖，考虑添加防抖/节流

未来规划

Vue Hooks Plus 团队将持续优化 useRequest 的性能和稳定性，同时保持API的简洁性。这一变更虽然短期内可能带来一些迁移成本，但从长远来看将提高项目的可维护性和性能表现。

开发者如有任何疑问或遇到迁移困难，可以参考项目文档或通过社区渠道寻求帮助。团队将持续关注开发者反馈，确保平滑过渡到新版本。