跳转到内容

忽略文件

在某些情况下,用户可能需要从同步中排除大文件或特定文件,例如占用大量存储空间的视频文件、临时文件等。

Sync Vault 会过滤以下几种文件:系统内置忽略文件正则表达式匹配的文件超过大小限制的文件,以及默认不开启同步的隐藏文件

打开 设置 → 同步 标签页,在 「1」云端冷备份 (Cloud Cold Backup) 区域的 配置同步参数 中找到以下选项:

  • 忽略文件:通过正则表达式排除文件或文件夹。
  • 跳过大文件:跳过大于指定大小(单位 MB)的文件。
  • 同步其他文件:是否同步以 . 开头的隐藏文件(包括主题和插件)。
文件过滤

以下文件始终不会被同步,无需手动配置:

类型文件
操作系统垃圾文件.DS_Store (macOS)、Thumbs.db (Windows)、Desktop.ini (Windows)
版本控制.git
Obsidian 工作区状态workspaceworkspace.jsonworkspace-mobile.json
回收站.trash
其他.ignore.tmp.sync-vault-debug

另外,插件自身文件(obsidian-sync-vaultsync-vault-ce)、VFS 虚拟存根文件(.osvc)、同步状态目录(.data)也会被自动忽略。

忽略文件 输入框中填写正则表达式,匹配的文件(仓库内的相对路径,以 / 分隔)将被排除。例如:

过滤项正则表达式
任意位置的 A/file.mdA/file\.md$
A/file.mdB/file.mdA/file\.md$|B/file\.md$
AB 文件夹下的所有文件/(A|B)/
所有 .bak 备份文件\.bak$
所有 .zip 压缩包\.zip$
TIP

正则匹配的是仓库内的相对路径(以 / 分隔)。若不确定正则怎么写,可参考 忽略文件示例,或用正则工具(如 RegExr)验证后再填入。

同步浏览器 中可通过 Ignored 筛选查看被忽略的文件。

跳过大文件 中设置大小上限(单位 MB,默认 100),大于该值的文件将被跳过,不会上传到云端。该限制只影响之后新增或修改文件的同步,不会删除云端已有文件。

默认情况下,以 . 开头的隐藏文件不会被同步。如需同步主题、插件等隐藏文件,请在 配置同步参数 中打开 同步其他文件 开关。