uniapp 清理本地缓存

### 如何在 UniApp 中清理本地缓存

#### 使用 `uni.clearStorage` 方法清除全部本地存储

为了彻底清除所有的本地存储数据，可以调用 `uni.clearStorage()` 函数。此方法会移除所有通过 `uni.setStorageSync` 或者异步版本设置的数据项。

// 清理所有本地缓存
uni.clearStorage();
console.log('已清空所有本地缓存');

这种方法简单直接，适用于希望一次性删除所有缓存的情况[^1]。

#### 针对性地移除特定键名的缓存条目

如果只需要删除某些指定名称的缓存，则应该采用 `uni.removeStorageSync(key)` 同步函数或其对应的异步形式来进行操作：

try {
    // 移除名为 'userToken' 的单个缓存条目
    uni.removeStorageSync('userToken');
    console.log('已成功移除 userToken 缓存');
} catch (e) {
    console.error('移除缓存失败:', e);
}

这种方式允许更精细地控制哪些数据被保留而哪些需要被清除。

#### 定期自动清理过期缓存机制

对于应用内存在有效期限制的数据（如登录凭证），建议实现定期检查并清理的功能。可以在每次启动时执行如下逻辑:

function clearExpiredCache() {
    const now = Date.now();

    try {
        let keys = Object.keys(uni.getStorageSync());
        
        for (let key of keys) {
            let item = JSON.parse(uni.getStorageSync(key));
            
            if (!item || !item.expirationDate || item.expirationDate <= now) {
                uni.removeStorageSync(key);
                continue;
            }

            // 更新未到期项目的存储时间戳
            item.storedAt = now;
            uni.setStorageSync(key, JSON.stringify(item));
        }
    } catch (error) {
        console.warn('处理缓存过程中出现问题', error);
    }
}

clearExpiredCache(); // 应用于 App.vue created 生命周期钩子或其他合适位置

这段代码遍历当前存在的所有缓存记录，并依据预设的有效期限决定是否要将其丢弃。这样既保持了必要的历史状态又不会让无用的信息占用过多空间[^4].