Obsidian自动备份,Git插件完整配置指南:45个设置项中文翻译 + 使用建议

将 Obsidian 知识库与 Gitee 远端仓库关联，实现自动备份同步。

前置准备

在配置插件之前，请确保已完成以下操作：

安装 Git

：终端执行 git --version 确认已安装

配置 Git 用户信息

：

git config --global user.name "你的用户名"

git config --global user.email "你的邮箱"

在知识库文件夹中初始化 Git 仓库

：

cd /你的/知识库/文件夹路径

git init

git remote add origin https://gitee.com/你的用户名/你的仓库名.git

gitadd.

git commit -m"init: obsidian vault"

git push -u origin master

在 Obsidian 中安装并启用 Git 插件

（社区插件中搜索 "Obsidian Git"）

插件设置总览

以下按设置页面的顺序，列出所有设置项的个人使用建议：

一、Automatic（自动操作）

序号	设置项（英文）	中文意思	个人使用建议操作
1	Split timers for automatic commit and sync	分离 commit 和 push/pull 的计时器	✅ 开启，让 commit 和 push 使用不同的时间间隔
2	Auto commit interval (minutes)	自动提交间隔（分钟）	设为 `30`，每 30 分钟自动 commit
3	Auto commit after stopping file edits	停止编辑文件后自动提交	✅ 开启，编辑完文件后立即自动
4	Auto commit after latest commit	跟随手动提交的时间戳	⚪ 可选，开启后减少手动 commit 后的重复自动 commit
5	Auto push interval (minutes)	自动推送间隔（分钟）	设为 `30`，每 30 分钟自动 push 到远端
6	Auto pull interval (minutes)	自动拉取间隔（分钟）	设为 `30`，每 30 分钟自动从远端 pull
7	Auto commit only staged files	自动提交时只提交已暂存的文件	❌ 关闭，让每次 commit 自动提交所有修改过的文件
8	Specify custom commit message on auto commit	自动提交时弹窗让你自定义消息	❌ 关闭，使用默认消息模板，不弹窗打扰

二、Commit message（提交消息）

序号	设置项（英文）	中文意思	个人使用建议操作
9	Commit message on auto commit	自动提交时的消息模板	填 `vault backup: {{date}}`，`{{date}}` 会自动替换为当前时间
10	Commit message on manual commit	手动提交时的消息模板	可留空（留空则每次手动 commit 时弹窗让你输入），或填 `vault backup: {{date}}`
11	Commit message script	用脚本生成提交消息	留空，高级功能，一般用不到

三、日期格式 & Pull 设置

序号	设置项（英文）	中文意思	个人使用建议操作
12	`{{date}}` placeholder format	日期占位符的格式	填 `YYYY-MM-DD HH:mm:ss`
13	`{{hostname}}` placeholder replacement	主机名占位符的替换文本	留空，多设备区分用，个人使用不需要
14	List filenames affected by commit in the commit body	在提交消息中列出修改的文件名	✅ 开启，方便查看每次提交改了哪些文件
15	Merge strategy	合并策略	选 `Merge`，pull 时用 merge 方式合并
16	Merge strategy on conflicts	冲突时的合并策略	选 `None (git default)`，让 Git 默认处理

四、启动 & 同步

序号	设置项（英文）	中文意思	个人使用建议操作
17	Pull on startup	启动 Obsidian 时自动拉取	✅ 开启，每次打开 Obsidian 自动从远端拉取最新内容
18	Push on commit-and-sync	执行"提交并同步"时自动推送	✅ 开启
19	Pull on commit-and-sync	执行"提交并同步"时自动拉取	✅ 开启

五、Hunk management（块管理）

序号	设置项（英文）	中文意思	个人使用建议操作
20	Signs	在编辑器中显示修改标记（绿/红）	❌ 关闭，个人笔记库不需要，开启会影响阅读
21	Hunk commands	逐块暂存/撤销命令	❌ 关闭，配合 Signs 的高级功能，Signs 关了就没用

六、状态栏 & 视图

序号	设置项（英文）	中文意思	个人使用建议操作
22	Status bar with summary of line changes	状态栏显示行变更统计（+12 -3）	⚪ 可选，喜欢 VS Code 风格的可以开启
23	Show commit authoring information next to each line	在每行旁边显示提交作者信息	❌ 关闭，个人笔记库用不上，影响阅读
24	Show Author（History view）	历史视图中显示作者	选 `Hide`，个人使用不需要看作者
25	Show Date（History view）	历史视图中显示日期	✅ 开启，查看历史记录时能看到提交时间
26	Automatically refresh source control view on file changes	文件变更时自动刷新源代码管理视图	✅ 开启，改了文件后侧边栏自动更新状态
27	Source control view refresh interval	源代码管理视图刷新间隔	设为 `7000`（毫秒），避免频繁刷新卡顿

七、Miscellaneous（其他）

序号	设置项（英文）	中文意思	个人使用建议操作
28	Diff view style	差异对比视图样式	选 `Split`（分屏），左右对比最直观
29	Disable informative notifications	关闭提示性通知	✅ 开启，减少"已备份成功"等提示的打扰
30	Disable error notifications	关闭错误通知	❌ 关闭，错误通知必须保留
31	Hide notifications for no changes	没有变更时隐藏通知	✅ 开启，避免"没有需要提交的更改"提示
32	Show status bar	显示底部状态栏	✅ 开启，底部显示 Git 状态（分支、改动数量等）

八、文件菜单 & 提交作者

序号	设置项（英文）	中文意思	个人使用建议操作
33	File menu integration	文件菜单集成	✅ 开启，右键文件时出现 Git 操作选项
34	Show branch status bar	显示分支状态栏	✅ 开启，底部显示当前分支名
35	Show the count of modified files in the status bar	状态栏显示修改文件数量	✅ 开启，底部显示类似 `master · 3 changed`
36	Author name for commit	提交时的作者名字	⚠️ 必填，填你的名字或昵称
37	Author email for commit	提交时的作者邮箱	⚠️ 必填，填你的邮箱

九、Advanced（高级设置）

序号	设置项（英文）	中文意思	个人使用建议操作
38	Update submodules	更新子模块	✅ 开启，开着没坏处
39	Submodule recurse checkout/switch	子模块递归切换分支	✅ 开启
40	Custom Git binary path	自定义 Git 可执行文件路径	留空，系统一般能自动找到
41	Custom Git directory path	自定义 Git 目录路径	保持 `.git` 默认值
42	Additional environment variables	额外的环境变量	留空
43	Additional PATH environment variable paths	额外的 PATH 路径	留空
44	Custom base path (Git repository path)	自定义 Git 仓库路径	留空
45	Disable on this device	在当前设备上禁用插件	❌ 关闭（关闭 = 插件正常运行）

日常使用

常用命令

在 Obsidian 中按 Cmd+P 打开命令面板，搜索以下命令：

命令	用途
`Obsidian Git: Create backup`	手动 commit + push
`Obsidian Git: Pull`	手动从远端拉取
`Obsidian Git: Push`	手动推送到远端
`Obsidian Git: Open diff view`	查看文件修改了什么
`Obsidian Git: Open Git history`	查看所有提交记录

多设备同步注意事项

切换设备前，先手动执行一次Pull

不要同时在两台设备编辑同一个文件，减少冲突

遇到冲突时，插件会提示，需手动解决

建议 .gitignore 配置

在知识库根目录创建 .gitignore 文件：

.obsidian/workspace.json

.obsidian/workspace-mobile.json

.DS_Store

Thumbs.db

workspace.json 存储窗口布局等个人状态，不同设备间通常不需要同步。