返回教程库技术教程

Obsidian本机Git仓库-安装&上传流程清单

一、前置准备

  • 本地Obsidian库文件夹已准备完成
  • 远程Git空仓库已创建：
  • 注册GitHub账号，然后在主页左上角Top repositories点击New，进入Create a new repository 页面后，填一个Repository name名称，下面填入简单介绍，最后点击Create repository就建立了一个新仓库。

二、首次仓库初始化（适用于未创建过Git仓库的库）

  1. 进入库文件夹：终端输入cd （cd后面一定要有空格）后拖拽本地库文件夹到终端自动填充路径，回车
  2. 验证路径正确：执行ls -a，确认输出包含.obsidian文件夹
  3. 初始化Git仓库：git init
  4. 配置忽略规则：在库根目录创建.gitignore文件，粘贴笔记提供的忽略规则内容并保存
  5. 暂存全量文件：git add .（.gitignore会自动过滤敏感/冗余文件）
  6. 首次提交：git commit -m "initial commit"
  7. 绑定远程仓库：git remote add origin 你的GitHub仓库HTTPS地址
  8. 首次推送：git push origin main

三、敏感文件清理（适用于已误提交LiveSync密钥data.json的场景）

  1. 确保.gitignore已添加**/.obsidian/plugins/obsidian-livesync/data.json等敏感文件规则
  2. 从Git缓存移除敏感文件（保留本地文件）：git rm --cached .obsidian/plugins/obsidian-livesync/data.json
  3. 提交清理操作：git commit -m "chore: stop tracking livesync credentials"

四、可选优化配置

  1. 修复Git中文路径乱码：git config --global core.quotepath false
  2. 新增忽略规则：.gitignore添加*.torrent过滤无价值种子文件

五、日常变更上传流程

  1. 进入库文件夹（同初始化步骤1）
  2. 检查变更状态：git status，确认无敏感文件待提交
  3. 暂存所有变更：git add .
  4. 填写提交信息：git commit -m "自定义提交说明，比如feat: 新增XX笔记"
  5. 推送到远程仓库：git push origin main

六、常见报错处理

  • 报错fatal: not a git repository：未cd到正确的库根目录，确认目录下存在隐藏的.git文件夹

七、验证操作成功

  • 敏感文件清理成功标识：执行git status，显示deleted: .obsidian/plugins/obsidian-livesync/data.json但本地该文件仍存在
  • 推送成功标识：终端输出[分支名] -> [分支名]（比如main -> main） [Timestamp: 2026/03/24 12:40:03]

user: 请根据00_Inbox里面的笔记，整理出Git 仓库安装和上传的全流程清单，不要编造笔记里没有的内容 [Timestamp: 2026/03/24 12:47:40]

ai: # Git 仓库安装&上传全流程清单

一、前置准备

  1. 系统已安装Git（官网地址：https://git-scm.com/）[^1]
  2. GitHub已创建空仓库：创建时选择「No .gitignore」1
  3. Obsidian已安装第三方插件「Obsidian Git」2
  4. 本地Obsidian库文件已整理完成

二、核心忽略规则配置（根目录创建.gitignore文件）

# ===================== 隐私与安全（最高优先级） =====================
# 严禁上传 LiveSync 的连接凭据和加密密钥
**/.obsidian/plugins/obsidian-livesync/data.json
**/.obsidian.mobile/plugins/obsidian-livesync/data.json
 
# ===================== Obsidian 核心配置 =====================
# 1. 追踪配置文件夹本身
!.obsidian/
!.obsidian.mobile/
# 2. 忽略临时状态和臃肿缓存
.obsidian/logs/
.obsidian/cache/
.obsidian/workspace.json
.obsidian/workspace-mobile.json
.obsidian/ui-state.json
.obsidian/global-state.json
.obsidian.mobile/logs/
.obsidian.mobile/cache/
.obsidian.mobile/workspace.json
.obsidian.mobile/workspace-mobile.json
.obsidian.mobile/ui-state.json
.obsidian.mobile/global-state.json
# 3. 忽略插件生成的冗余索引
.makemd/
.space/
 
# ===================== 系统与杂项 =====================
.trash/
.DS_Store
Thumbs.db
*.tmp
*.bak
*.sync-conflict-*
*.torrent # 可选，过滤无价值种子文件
 
# ===================== 追踪规则（确保笔记和附件不丢失） =====================
!*.md
!*.png
!*.jpg
!*.jpeg
!*.pdf
!*.canvas

31

三、仓库初始化（终端操作）

场景1：全新未初始化过Git的库

  1. 进入库文件夹：终端输入cd 后拖拽本地Obsidian库文件夹到终端自动填充路径，回车
  2. 验证路径正确：执行ls -a，确认输出包含.obsidian文件夹
  3. 初始化Git仓库：git init
  4. 暂存全量文件：git add .（.gitignore会自动过滤敏感/冗余文件）
  5. 首次提交：git commit -m "initial commit"
  6. 绑定远程仓库：git remote add origin 你的GitHub仓库HTTPS地址2
  7. 锁死拉取权限（仅上传不下载，避免冲突）：git config remote.origin.fetch ""2
  8. 首次推送：git push -u origin main

场景2：之前删除过.git文件夹的库

执行场景1的步骤3-8即可3

四、敏感文件清理（仅适用于已误提交LiveSync密钥data.json的场景）

  1. 确保.gitignore已添加上述data.json相关忽略规则
  2. 从Git缓存移除敏感文件（保留本地文件）：git rm --cached .obsidian/plugins/obsidian-livesync/data.json3
  3. 提交清理操作：git commit -m "chore: stop tracking livesync credentials"3

五、Obsidian Git 插件自动备份配置

  1. 打开Obsidian「设置」→ 找到「Obsidian Git」插件设置
  2. 基础配置：
    • 「Remote Repository URL」：粘贴GitHub仓库HTTPS地址
    • 「Git Remote Name」：默认填origin
    • 「Branch」：填main（GitHub默认分支名）
  3. 关闭所有拉取相关选项（避免冲突）：
    • Auto pull on startup（启动时自动拉取）
    • Auto pull before push（推送前自动拉取）
    • Pull changes on interval（定时拉取）
    • Auto merge（自动合并）
  4. 开启自动备份选项：
    • Auto commit（自动提交，建议间隔：60分钟）
    • Auto push（自动推送，建议间隔：120分钟）
    • Push on startup（启动Obsidian时推送一次）
    • Commit on file change（文件修改时自动提交）
  5. 首次手动触发：点击左侧栏「Git」图标→ 「Commit All Changes」，填写提交信息后确认，再点击「Push」，首次推送按提示登录GitHub即可2

六、可选优化配置

  1. 修复Git中文路径乱码：git config --global core.quotepath false3
  2. 自定义Git二进制路径（若插件提示「Git is not ready」）：
    • macOS终端执行which git获取路径（如/usr/bin/git）
    • 将路径填入插件设置的「Custom Git binary path」，重启Obsidian即可2

七、操作成功验证标准

  1. 敏感文件清理成功：执行git status，显示deleted: .obsidian/plugins/obsidian-livesync/data.json但本地该文件仍存在3
  2. 推送成功：终端输出类似e62091c..864b105 main -> main的提示3
  3. 自动备份生效：修改一篇笔记后等待插件自动同步，刷新GitHub仓库可看到对应修改记录2

Sources

Footnotes

  1. [[GitHub登录账号]] ↩ ↩2

  2. [[10_项目ing/obsidian技能研究/Obsidian超级备份Git仓库设置]] ↩ ↩2 ↩3 ↩4 ↩5 ↩6

  3. [[10_项目ing/obsidian技能研究/Git仓库上传设置（含脚本）]] [Timestamp: 2026/03/24 12:49:44] ↩ ↩2 ↩3 ↩4 ↩5 ↩6 ↩7

留言

加载中…