Obsidian 插件安装教程
obsidian 的一个很常见的问题就是如何同步，网上现在有很多种同步方案，我现在分享给大家我用的最多，也是比较舒服的方案
不谈背景直接说方案没有价值，我的使用场景是跨系统跨主机的笔记同步，并没有手机同步的需求，手机最多使用 anki 背背卡片，工作还是要在 pc 端进行
使用 git 在 github 上进行托管是因为从事软件行业用起来比较熟练，遇到一些常见的问题直接就解决了，还能提高使用的熟练度，本文放了一些常见的问题，如果遇到了更多的问题欢迎反馈，我会随时更新，关注不迷路
同样，如果大家有什么问题或更好的建议欢迎在下方评论或私信我，如果没有及时回复你可以在我的公众号<文件夹的知识圈>找到我
git 的介绍在网上可以一搜一大把，简单来说 git 就是一个内容跟踪器，支持版本控制、多人开发甚至还可以用来同步 obsidian 的笔记
git 在各平台的安装请参考 git 官网安装 git
对于 windows 来说，可以直接找到对应的仓库文件夹然后选中如图路径会变蓝，键入 powershell 回车即可打开如第二个图所示的终端框，注意 cmd 和 powershell 打开的终端命令不一样请用 powershell
对于 macos 来说可以在应用处的其它里面打开终端然后通过 cd path 进入对应仓库文件夹
git config --global user.name "abc"
git config --global user.email abc@gmail.com
输入下面的命令
ssh-keygen -t rsa -C "abc@gmail.com"
生成的过程中一直回车即可，默认的存放位置在家目录下的 .ssh 文件夹下
windows 和 mac 这一步的命令是一样的，只不过需要把 \ 改为 /，通过下面命令打印出对应 id_rsa.puh 中的公钥
cat ~\.ssh\id_rsa.pub
在注册好 github 账号并登录成功后，会进入主页，首先创建对应的笔记仓库，点击这里
进去以后需要填写对应的仓库名并把仓库设置成私有，如果有分享笔记给其他人的需求可以设置成公开
完成后点击右下角的 Create repository，保持这一页面先不要关
首先在这个页面的右上角左键点击你的头像会出现下面的样子，然后右键点击在新标签页打开，注意不要覆盖掉当前页
打开后按照下图依次点击
在新的界面处，依次填入名称、从终端中复制出来的完整秘钥并点击 Add SSH key，然后就算是添加成功了
在仓库文件夹下也就是 .git 的统计目录下创建名为 .gitignore 文本，在里面输入以下内容
这样设置的目的是不同步 obsidian 自带的 .trash 垃圾文件夹和当前工作区状态的配置文件，这个配置文件在同步的时候会经常性的出现 git 冲突，非常的恶心，如果有其它不想要同步的内容都可以加在这里面，这两个文件是不影响多端同步的，否则需要手动的同步
对仓库的本地仓库进行设置设置的步骤为
git init
git commit -m "first commit"
git branch -M main
git remote add origin git@github.com:xxx/xxx.git
git push -u origin main
这里的 xxx/xxx.git 和上面那个不让关闭的页面里面的命令保持一致，正常来说如果网络正常且步骤正常此时刷新刚才没有关闭的网页会发现里面有内容了，同时内容中没有 .trash 并且 .obsidian 文件夹下没有 workspace.json 的文件
在上述内容都完成后，就可以进行 obsidian 的插件下载和配置了，如果不出意外再也不需要打开黑乎乎的终端手动推送了，插件下载第一是在官方社区搜索 Git 对第一个进行下载启用，或者去我的公众号 <文件夹的知识圈> 发送 <插件下载> 在对应的文件夹中找到 obsidian-git 即可下载，安装教程请参考 Obsidian 插件安装教程
下载安装并且启用后不需要进行任何的设置，常用的命令就三个，首先打开对应的 obsidian 仓库，使用 ctrl/cmd + p 打开命令行，三个命令分别是 Git: commit all changes 、Git: Push 和 Git: Pull，三个命令分别对应了提交本地仓库的修改，推送本地仓库的修改到远端和从远端将修改下拉到本地，接下来会介绍对应的使用场景
为什么说是上层目录呢，因为从远端 clone 下来的是一个文件夹，比如说你的仓库名为 note，你想把它存到 Document 目录下，你就需要打开 Document 下的终端，等完成后 Document 下就是你对应的 note 文件夹
git clone xxx xxx 就是步骤 2 中复制的内容，然后回车就可以从远端下拉下来了一个正常的同步流程就是，一个电脑产生了修改，然后另一个电脑想要同步这个修改，只需要参照下面的步骤即可
ctrl/cmd + p 打开命令行，键入 Git: Commit all changes，在右上角会闪过如下图
Git: Pull 把本地仓库和远端同步一下，会在右上角看到 pull 多少文件下来或者 everything is updated 的字样Git: Push 将本地的修改推送到远端即可由于 github 需要魔法，所以在所有和 github 互动的操作中都需要保持魔法
此种情况出现在可以正常访问 github 但是无法正常的 push 和 pull，解决流程为
127.0.0.1 端口号为 7890git config --global http.proxy 127.0.0.1:7890
git config --global https.proxy 127.0.0.1:7890
这说明之前已经生成过秘钥了，所以再在本地配置的时候不会产生覆盖，打开对应的 id_rsa.pub 文件查看真是的用户名和邮箱是什么然后使用下面命令进行全局修改即可，其中第一个 xxx 是用户名，第二个是邮箱
git config --global user.name "xxx"
git config --global user.email xxx
$ vim ~/.ssh/config
```# Add section below to it
Host github.com
Hostname ssh.github.com
Port 443```
$ ssh -T git@github.com
Hi xxxxx! You've successfully authenticated, but GitHub does not
provide shell access.
这个方案有效的前提是：执行命令 ssh -T -p 443 git@ssh.github.com 后不再提示 connection refused
如果还是出现问题，可以通过
$ ssh -vT git@github.com
查看建立 ssh 连接的过程中发生了什么，这个命令会打出详细日志
输出的日志中会显示，连接的是 Github 的哪个 ip 和哪个端口，如果 ip 可以通过网页访问正常打开，并且端口也是 443 就不会有问题了
首先问题并不是 id_rsa_pub 的问题，因为这个已经正常添加到了仓库中，没有问题
问题是在新建仓库的时候手动添加了一个 readme，所以导致远程仓库和本地要提交的仓库结构不统一，没有相同的历史节点，所以提交被拒绝，解决办法如下
git pull origin main --allow-unrelated-histories
Your local changes to the following files would be overwritten by merge: .idea/vcs.xml
表明本地有修改未 commit，先 commit 即可
git push origin main 即可说明在 helloword 的子目录中存在.git 文件，删除或者压缩成压缩包即可
error: invalid object 100644 b15902813faa5292b67e974406facf6e5f1f06c5 for 'xx.md'
error: invalid object 100644 b15902813faa5292b67e974406facf6e5f1f06c5 for 'xx.md'
error: Error building trees
解决步骤如下
git rm --cached 'xx.md' 注意 windows 需要使用双引号git add 'xx.md'然后就可以正常 commit 和 push 了
切换 git 使用的内置 ssh.exe
git config --global core.sshCommand "C:/Windows/System32/OpenSSH/ssh.exe"
这个时候需要保证远端仓库是正确的，将本地仓库的修改单独拿出来，然后 clone 远端仓库，再将修改手动添加回去，可以是一段一段加，也可以是直接一个把修改过的 md 文件复制过来
提示：请勿发布广告垃圾评论，否则封号处理！！