7.0 KiB
Git 基础知识
Git 是一个版本控制工具。它可以记录文件夹在不同时间点的状态，让我们知道改了什么、什么时候改的，也可以把本地内容同步到 GitHub 这样的远程仓库。
三个核心位置
工作区 workspace：
你平时直接看到和编辑的真实文件夹，比如 Obsidian 里的 .md 笔记、图片、模板等。
本地仓库 local repository：
工作区里有一个隐藏目录 .git 后，这个文件夹就成为 Git 本地仓库。.git 里保存提交历史、分支、远程地址等信息。
远程仓库 remote repository：
放在 GitHub、Gitee 等平台上的仓库。比如：
https://github.com/Ki5ter/Obsidian.git
本地仓库和远程仓库不是同一个东西。commit 只提交到本地，push 才会上传到远程。
常见概念
stage/index 暂存区：
准备放进下一次提交的改动。可以理解为“这次 commit 我要带上的内容清单”。
commit 提交：
一次本地快照。提交后，Git 会记住当前这批改动。
branch 分支：
一条提交历史线。常见主分支名是 main 或 master。
remote/origin：
远程仓库地址的别名。通常把 GitHub 远程仓库命名为 origin。
push 推送：
把本地 commit 上传到远程仓库。
pull 拉取：
从远程仓库下载最新改动，并合并到当前本地分支。
fetch 获取：
只下载远程仓库信息，不自动合并。
origin/master：
本地记录的远端 origin 上 master 分支的位置。它不是远端本身，而是本地上次获取到的远端状态。
基本工作流程
- 打开工作区，也就是要纳入版本控制的文件夹。
- 执行
git init，把文件夹初始化成本地 Git 仓库。 - 配置远程仓库，也就是添加
origin。 - 修改、新增或删除文件。
- 把改动加入暂存区。
- 提交到本地仓库。
- 推送到远程仓库。
对应命令：
cd "E:\Obsidian\OneDrive\Apps\remotely-save\MyNotes"
git init
git remote add origin https://github.com/Ki5ter/Obsidian.git
git add .
git commit -m "Initial Obsidian notes backup"
git push -u origin main
如果当前分支叫 master，推送命令也可以是：
git push -u origin master
main 和 master
main 和 master 都可以作为主分支名。
现在 GitHub 新仓库通常默认使用 main，旧仓库或某些工具可能默认使用 master。
把当前分支改名为 main：
git branch -M main
第一次推送并设置上游分支：
git push -u origin main
-u 的意思是把本地分支和远程分支关联起来。设置过一次后，以后可以直接使用：
git push
git pull
origin、master 和 push
origin 是远端仓库地址的别名。它保存在本地 Git 配置里，不是 GitHub 天生的名字。
git remote add origin https://github.com/Ki5ter/Obsidian.git
如果需要推送到多个远端，可以添加多个别名：
git remote add backup https://example.com/backup.git
master 是分支名，也可以叫 main、dev、notes。分支可以理解为一个指向最新提交的指针。
git push origin master
这条命令表示把本地 master 分支推送到 origin 远端。它不会自动推送其他本地分支。
第一次推送时常用：
git push -u origin master
-u 会设置上游关系。之后在本地 master 分支上执行 git push 或 git pull，Git 会自动使用 origin/master。
常用检查命令
查看当前仓库状态：
git status
查看当前分支：
git branch
查看本地分支和远程分支关系：
git branch -vv
查看远程仓库地址：
git remote -v
查看提交历史：
git log --oneline --decorate -5
查看某个路径是否被 ignore 命中：
git check-ignore -v --no-index -- "密码本/任意测试文件.md"
查看某个路径是否还被 Git 跟踪：
git ls-files -- "密码本" "服务器迁移"
.gitignore 的作用
.gitignore 用来告诉 Git：哪些未被跟踪的新文件不要加入版本控制。
推荐把只在仓库根目录生效的目录写成：
/密码本/
/服务器迁移/
开头的 / 表示仓库根目录，结尾的 / 表示目录。
如果只写：
密码本
也能生效，但它会匹配仓库中任何位置名为 密码本 的文件或目录，不如 /密码本/ 精确。
已经被 Git 跟踪过的文件不会因为加入 .gitignore 自动消失。需要执行：
git rm --cached -r -- "目录或文件名"
这会从 Git 跟踪列表中移除文件，但保留本地实际文件。
清理历史中的敏感内容
如果敏感文件已经推送到远程仓库，只在最新提交中删除还不够，旧提交里仍然可能看到。
清理历史的思路是：重写本地提交历史，让每个相关提交都不再包含敏感路径，然后强制替换远端分支。
示例：
git filter-repo --path "密码本/" --path "服务器迁移/" --invert-paths
git fetch origin
git push --force-with-lease origin master
git filter-repo 不是 Git 自带命令，需要单独安装。--invert-paths 表示反转路径选择：保留其他所有路径，移除 --path 指定的路径。
普通 git push 只允许向前追加提交。重写历史后，本地提交 ID 已经变化，远端会拒绝普通 push，因此需要：
git push --force-with-lease origin master
--force-with-lease 比 --force 更安全。它会检查远端分支是否仍停在本地记录的位置；如果别人已经推送了新提交，它会拒绝覆盖。
敏感信息如果已经泄露过，清理 Git 历史只是补救之一。密码、Recovery Key、Token 等应视为已经泄露，优先更换或吊销。
Obsidian 笔记库使用 Git 的注意事项
Obsidian 笔记库适合用 Git 备份，因为大多数内容都是 Markdown 文本文件。
建议提交：
.md 笔记
图片、附件
模板
必要的 .obsidian 配置
谨慎提交：
密码、密钥、Token
个人隐私内容
插件缓存
特别大的二进制文件
建议忽略：
/.obsidian/workspace*.json
/.obsidian/cache/
/.vs/
/密码本/
/服务器迁移/
workspace*.json 是 Obsidian 的窗口和布局状态，通常和具体电脑有关。.vs/ 是 Visual Studio 本地缓存，也不适合提交。
如果笔记库在 OneDrive 里，要注意 .git 目录必须真实保留在本机。否则 Git 或 Visual Studio 可能会报错，例如：
not a git repository
Permission denied
The cloud file provider is not running
处理方式是在资源管理器里右键笔记库文件夹，选择：
始终保留在此设备上
重点是整个笔记库和 .git 目录都要保留在本机。