问题分析
项目中setTimeout的使用存在以下潜在问题:
1. 内存泄漏风险
组件卸载时未清理定时器,导致内存泄漏
2. 硬编码延迟
使用固定的延迟时间(如100ms),不够灵活
3. 缺乏统一管理
定时器分散在各处,难以统一管理和清理
4. 重复代码
防抖、节流等逻辑重复实现
优化方案
创建统一的定时器管理工具
在src/utils/timer.ts中提供以下功能:
- 防抖函数 (debounce):避免频繁触发
- 节流函数 (throttle):限制执行频率
- 延迟执行 (delay):替代
setTimeout,返回取消函数 - 重试函数 (retry):带指数退避的重试机制
- DOM就绪等待 (waitForDOMReady):替代硬编码的延迟初始化
- 定时器管理器 (TimerManager):统一管理所有定时器,自动清理
- Vue组合式API (useTimer):在组件中使用,自动在卸载时清理
优化后的使用场景
场景1:DOM初始化延迟
优化前:
setTimeout(() => {
initMap()
}, 100)
优化后:
waitForDOMReady(() => {
vueNextTick(() => {
initMap()
})
})
场景2:防抖处理
优化前:
let debounceTimer: ReturnType<typeof setTimeout> | null = null
const calculateHeight = () => {
if (debounceTimer) {
clearTimeout(debounceTimer)
}
debounceTimer = setTimeout(() => {
// 计算逻辑
}, 100)
}
优化后:
const [calculateHeight] = debounce(() => {
// 计算逻辑
}, 100)
场景3:重试机制
优化前:
const trySetTitle = (attempts = 0) => {
const popupMenu = document.querySelector('.el-menu--popup')
if (popupMenu) {
// 设置标题
} else if (attempts < 50) {
setTimeout(() => trySetTitle(attempts + 1), 10)
}
}
优化后:
retry(
async () => {
const popupMenu = document.querySelector('.el-menu--popup')
if (!popupMenu) throw new Error('Not found')
// 设置标题
},
50, // 最大尝试次数
10, // 初始延迟
500 // 最大延迟
)
场景4:组件内定时器管理
优化前:
let timer: ReturnType<typeof setTimeout> | null = null
onMounted(() => {
timer = setTimeout(() => {
// 逻辑
}, 100)
})
onUnmounted(() => {
if (timer) {
clearTimeout(timer)
}
})
优化后:
const { manager: timerManager, clearAll: clearAllTimers } = useTimer()
onMounted(() => {
timerManager.setTimeout(() => {
// 逻辑
}, 100)
})
onUnmounted(() => {
clearAllTimers()
})
性能影响分析
优化前的问题
- 内存泄漏:组件卸载后定时器仍在运行,占用内存
- CPU占用:未清理的定时器持续执行,浪费CPU资源
- 响应延迟:硬编码的延迟时间可能过长或过短
优化后的改进
- 自动清理:组件卸载时自动清理所有定时器,避免内存泄漏
- 统一管理:所有定时器集中管理,便于监控和调试
- 更好的时机控制:使用
waitForDOMReady和nextTick替代硬编码延迟 - 代码复用:防抖、节流等逻辑统一实现,减少重复代码
已优化的文件
- ✅
src/views/Home/components/CoverageSection.vue- DOM初始化延迟 - ✅
src/components/Layout/SidebarLayout.vue- 菜单标题更新和重试机制 - ✅
src/views/DisabilityAppraisal/DisabilityAssessment/Index.vue- 数据加载延迟 - ✅
src/utils/multiWindowSync.ts- 登出标记重置 - ✅
src/components/BaseTable.vue- 防抖计算高度
使用建议
- 新代码:优先使用
src/utils/timer.ts中的工具函数 - 组件内定时器:使用
useTimer()钩子自动管理 - DOM相关延迟:使用
waitForDOMReady替代硬编码延迟 - 防抖/节流:使用
debounce和throttle函数 - 重试逻辑:使用
retry函数替代手动重试
注意事项
- 所有使用
useTimer()的组件,都会在卸载时自动清理定时器 debounce和throttle返回的取消函数,可以在需要时手动取消waitForDOMReady有最大等待时间限制(默认5秒),避免无限等待retry函数使用指数退避策略,避免频繁重试