教程

排除不想同步的内容:文件夹、单个文件和「.」开头的隐藏内容

手机电脑同步插件 · ·使用教程

版本要求:本篇介绍的「排除单个文件」和「排除 . 开头的隐藏内容」是 2.8.1 版本起支持的(2026-08-17 起通过插件自动更新推送,更新会自动下载、重启 Obsidian 后生效)。旧版本只能排除普通文件夹;如果你的界面和截图对不上,先等自动更新,或到教程站首页下载最新安装包手动覆盖。

一、排除功能能做什么

排除 = 让指定内容不参与同步(本设备不上传、也不下载它)。2.8.1 起可以排除四类东西:

能排除的内容例子效果
普通文件夹模板归档整个文件夹及其子项都不同步
单个文件资料/会议记录.md只这个文件不同步,同文件夹其它文件不受影响
「.」开头的隐藏文件夹(任意路径下)项目/代码库/.git整个隐藏文件夹不同步
「.」开头的隐藏文件(任意路径下)项目/.env只这个隐藏文件不同步

典型场景:库里有 git 仓库(.git 目录几万个小文件,既慢又占云端空间)、程序生成的缓存/配置文件(.env.DS_Store 一类)、或某几个纯本地的大文件。

📌 库根目录下「.」开头的内容(比如根目录的 .git.trash本来就永远不参与同步,不用也不需要手动排除。这个行为在 2.8.1 前后都一样。

二、入口在哪

打开 Obsidian 设置 → 第三方插件「手机电脑同步」,找到 「排除的文件夹和文件」 这一行(旧版本叫「排除的文件夹」),点 「管理…」

设置页「排除的文件夹和文件」入口,描述里能看到已排除的内容

手机端入口位置相同。已排除的内容会一直显示在这一行的描述里,一眼可见。

三、管理弹窗:两个选择入口

点「管理…」后是「管理排除内容」弹窗:上面是已排除列表(每条后面有「移除」按钮),下面是两个添加入口——选择文件夹选择文件。计数会告诉你库里有多少个可选项、其中多少个是「.」开头的隐藏条目:

「管理排除内容」弹窗:已排除列表 + 从文件夹选择 / 从文件选择两个入口

排除只能从选择器里挑、不能手动输入路径——这是刻意设计:手敲路径极易打错一个前缀,排除规则会静默失效。选择器里列出的都是库里真实存在的内容,选中即生效。

四、排除文件夹(包括隐藏文件夹)

「选择文件夹」,会列出库内全部文件夹——包括任意路径下「.」开头的隐藏文件夹(Obsidian 自己的文件列表里看不到它们,但选择器会扫出来)。支持输入关键字搜索:

文件夹选择器:普通文件夹和「.」开头的隐藏文件夹(如 项目/代码库/.git)都在列表里

排除文件夹的效果是整个子树:文件夹本身 + 里面所有文件和子文件夹都不再同步。

五、选择排除范围:只本机,还是所有设备

选中内容后会问你排除范围。两种方式都不会删除任何设备上的本地文件

「排除范围」弹窗:只本机排除 / 所有设备排除

  • 只本机排除:仅这台设备停止同步它,其它设备照常。适合「这台电脑不需要这些内容」的场景。
  • 所有设备排除:所有设备都停止同步它,并清除云端副本、腾出同步空间。适合「这些内容根本不该进云端」的场景(比如整个 .git)。

六、排除单个文件(包括隐藏文件)

「选择文件」,列出库内全部文件——同样包括「.」开头的隐藏文件。输入关键字快速过滤:

文件选择器:输入「项目」过滤后,普通文件和隐藏文件 项目/.env 都可以选

单个文件的排除是精确的:只影响这一个文件,不会波及同名前缀的其它内容。

七、注意事项

  • 排除不删除任何东西:本机文件原样留着;「只本机排除」时云端已有的副本也保留。
  • 想释放云端空间:把内容设为「所有设备排除」(会顺带清云端副本);或者对「只本机」的排除项,确保每台设备都排除了同一路径后,再用设置页的「从服务端移除排除目录」清理——否则未排除的设备会把内容重新传上去。
  • 撤销排除:回到「管理排除内容」弹窗,点对应条目的「移除」(所有设备排除的条目是「取消排除」),内容会重新参与同步。
  • .obsidian 配置目录不走本篇的排除功能,它由设置页里「文件类型」「主题、插件、配置」相关开关独立管理。

八、常见问题

Q:我的设置页里只有「选择文件夹」,没有「选择文件」? 你的插件还是 2.8.1 之前的版本。2026-08-17 起会通过自动更新推送,更新后重启 Obsidian 即可;也可以到教程站首页下载最新安装包手动覆盖安装。

Q:排除了一个文件夹,另一台设备上它还在同步? 「只本机排除」只对操作的那台设备生效。想全家桶生效,用「所有设备排除」,或在每台设备上分别排除。

Q:为什么选择器里看不到根目录的 .git? 库根目录下「.」开头的内容永远不参与同步,无需排除,所以选择器不列出它们。子文件夹里的 .git(如 项目/代码库/.git)默认是会同步的,需要排除时在文件夹选择器里选它即可。

Q:排除之后又建了同名文件/文件夹会怎样? 排除规则按路径生效:同路径的新内容同样不参与同步,直到你移除这条排除。