跳到主要内容

过滤规则

FolderRewind 的过滤分为两类：

  • 黑名单：影响备份阶段（不打包匹配项）
  • 还原白名单：影响 Clean 还原阶段（清理时跳过匹配项）

配置入口​

  1. 打开目标配置。
  2. 点击 配置设置。
  3. 在：
    • 过滤器 里配置黑名单
    • 还原策略 里配置还原白名单

配置设置中的过滤器选项卡

三种过滤列表​

FolderRewind 中有三种独立的过滤列表，分别在不同阶段生效：

列表配置位置生效阶段作用
黑名单过滤器 → 黑名单备份时排除匹配的文件/文件夹
备份白名单过滤器 → 白名单备份时（仅白名单模式）仅包含匹配的文件/文件夹
还原白名单还原策略 → 还原白名单Clean 还原时清理目标目录时保留匹配项

注意：黑名单和备份白名单是互斥的（通过过滤模式切换），还原白名单是独立的，两种备份模式下都可以配置。

备份过滤模式​

FolderRewind 支持两种备份过滤模式，在 配置设置 → 过滤器 中切换：

模式说明适用场景
黑名单模式（默认）排除匹配文件，其余全部备份大多数场景，排除缓存/日志/临时文件
白名单模式仅备份匹配文件，其余全部排除只想备份特定类型文件
选择建议

如果你只想排除少量文件，用黑名单模式。如果你只想备份少量特定文件，用白名单模式。

黑名单（备份阶段）​

黑名单规则会在扫描文件时生效，常见用途：排除缓存、日志、临时文件。

v1.6.1 对黑/白名单匹配行为做了收敛优化，避免规则过于宽泛导致误匹配。建议你按更精确的方式编写规则。

支持的匹配方式​

  • 文件名精确匹配（例如 latest.log）
  • 路径包含匹配（例如 node_modules）
  • 通配符匹配（*、?）
  • 正则规则（regex: 前缀，需开启“使用正则”）

示例​

  • *.tmp
  • cache
  • regex:^logs/.*\\.txt$

白名单模式示例​

切换到白名单模式后，只有匹配规则的文件会被备份。

典型用途：

  • 只备份存档数据：*.dat、*.json
  • 只备份特定目录：saves、worlds
  • 只备份配置文件：*.yml、*.yaml、*.toml

示例规则：

  • *.dat
  • *.json
  • saves
  • regex:^saves/[^/]+/level\.dat$

还原白名单（Clean 还原阶段）​

当你执行 Clean 还原 时，系统会先清理目标目录。 白名单中的文件/目录会在清理步骤被保留。

v1.6.1 同时修复了“白名单使用完整路径时不生效”的问题。现在可以稳定使用完整路径表达更精细的保留策略。

典型用途​

  • 保留本地配置文件
  • 保留环境差异文件（例如本机私有设置）

示例​

  • .env.local
  • user-settings.json
  • screenshots

实践建议​

  • 新增规则后先做一次手动备份并检查结果。
  • 规则尽量从“精确”到“宽泛”，避免误排除关键数据。
  • 正则规则建议先小范围验证，再用于正式配置。
  • 尽量避免单个过宽规则覆盖整个上级目录。
  • 对关键保留项优先使用完整路径，减少歧义。

常见问题​

开启正则后没有生效？​

请确认：

  • 规则以 regex: 开头
  • 已勾选“使用正则”
  • 表达式本身合法

还原后仍有旧文件残留？​

先检查是否使用了 Overwrite 还原；只有 Clean 还原才会执行“清理 + 白名单保留”逻辑。

相关链接​