【喂饭级教程】obsidian知识库多台电脑之间免费同步（在尝试 OneDrive、iCloud、坚果云之后，最后选择 GitHub 免费搞定）

沐白大男孩 2026年6月12日 15:35

不管你是 Mac + Windows 混用、多台 Mac、还是多台 Windows，这套方案都适用。 GitHub 免费版就够用，不限设备数量。

写在前面：为什么我要折腾多设备同步

我在打磨自己的 AI 人生操作系统——把想法、待办、知识库、每日复盘全都整合在一起。

问题来了：我有多台电脑，角色不同。有的电脑专门用来做输入和记录，有的电脑是主力机用来写文章、做深度研究。每天在多台设备之间切换，如果没有同步，A 电脑上记的想法，B 电脑上看不到，C 电脑上写的文章，D 电脑上没有。

为了解决同步，我试过这些方案：

最后我选了 GitHub。不只是因为免费，更是因为它的版本管理能力——每次改动都有记录，改错了可以回退，这是其他同步工具做不到的。

后面我还打算把整个电脑上的 skill 也用 GitHub 管起来。skill 是什么？简单说就是 AI 助手的能力插件，每个 skill 就是一套配置文件。之前换电脑、重装系统，skill 丢了要重新配，特别折腾。用 GitHub 管之后，不管换几台电脑、系统崩了几次，一条命令就能全部恢复，再也不怕 skill 丢失和混乱了。

这篇文章就是我的完整踩坑记录 + GitHub 同步的喂饭级教程。

GitHub 免费版的边界说明（很难触碰到）

对于知识库、笔记、文档类项目来说，这些限制完全够用。一本 30 万字的书大约也就 1-2 MB。100 MB 的单文件限制，基本只有视频和大图片才会碰到。

第一部分：准备工作

你需要准备什么

• 能上网的电脑（Mac 或 Windows 都行），每台都要装 Git
• 一个邮箱（注册 GitHub 用）
• 10 分钟时间

检查电脑是否已安装 Git

打开终端（Mac 叫”终端”，Windows 叫”PowerShell”或”Git Bash”），输入：

1

git --version

• 显示版本号（如 git version 2.45.0 ）→ 已安装，直接往下走
• 提示 command not found 或”不是内部命令”：
• Mac ：运行 xcode-select --install ，按提示安装命令行工具（包含 Git）
  • Windows ：去 https://git-scm.com ^[1] 下载安装包，安装时一路下一步即可

原理（30 秒看懂）

1
2

第一台电脑：本地文件 → 推到 GitHub（云端）
其他电脑：从 GitHub 拉下来 → 改完 → 再推回去

你要做的就两件事：

1. 第一台电脑 ：把本地项目上传到 GitHub
2. 其他电脑 ：从 GitHub 下载，以后随时同步

第二部分：核心流程（跟着做，一口气搞定）

下面的步骤按顺序做，不要跳。所有电脑不管是 Mac 还是 Windows，命令都一样。

步骤 1：注册 GitHub 账号

所有电脑共用一个账号。

1. 打开 https://github.com ^[2]
2. 输入邮箱 → 设密码 → 选用户名
3. 完成验证（邮箱确认码）
4. 免费版（Free）就够用，不用付费

步骤 2：创建仓库

仓库 = GitHub 上的一个项目文件夹。

1. 登录 GitHub → 点右上角 + → New repository
2. 填写：

• Repository name ：比如 my-project
  • Private （选私有，自己的东西不公开）

4. 下面三个选项 全部不勾 ：

• Add a README file → 不勾
  • Add.gitignore → 不勾
  • Choose a license → 不勾

6. 点 Create repository
7. 创建后 GitHub 会显示一个地址，类似： https://github.com/你的用户名/my-project.git

记住这个地址，后面所有电脑都要用到。

步骤 3：生成 Personal Access Token

GitHub 不用密码登录，用 Token 代替密码。建议每台电脑生成一个，方便管理。

为什么每台电脑各一个？

如果某台电脑出了问题，直接在 GitHub 上删掉那台电脑的 token 就行，其他电脑不受影响。

嫌麻烦的话，一个 token 所有电脑共用也行。

生成步骤

1. GitHub → 右上角头像 → Settings
2. 左侧菜单拉到最下面 → Developer settings
3. Personal access tokens → Tokens (classic)
4. 点 Generate new token (classic) （页面上有两个按钮，选这个，更简单）
5. 填写：

• Note ：写机器名，比如 办公室Mac 、 家里Mac 、 Windows台式机
  • Expiration ：选 No expiration （不过期）
  • Select scopes ：只勾 repo 这一个大项（其他都不勾）

7. 点最下面绿色按钮 Generate token
8. 马上复制保存到备忘录 （关了页面就看不到了！）

步骤 4：第一台电脑上传项目

不管这台电脑是 Mac 还是 Windows，流程完全一样。

4.1 配置加速（国内用户建议做）

国内直连 GitHub 可能很慢或超时。在终端执行：

1

git config --global url."https://ghfast.top/https://github.com/".insteadOf "https://github.com/"

原理 ：让所有 github.com 的请求自动走 ghfast.top 中转。 ghfast.top 是社区维护的免费加速服务，只做流量转发，不修改你的代码内容。

已经有其他加速方式（VPN、代理等）的可以不配。能正常 push 就行。

4.2 设置身份信息

1
2

git config --global user.email "你注册GitHub的邮箱"
git config --global user.name "你的GitHub用户名"

每台电脑都要设一次，以后就不用了。

4.3 初始化项目

1
2
3
4
5

# 进入你的项目文件夹
cd "你的项目路径"

# 初始化 Git
git init

4.4 创建.gitignore

在项目文件夹下创建 .gitignore 文件：

• Mac： touch .gitignore 然后 open .gitignore
• Windows： notepad .gitignore

写入以下内容：

1
2
3
4
5

node_modules/
.DS_Store
Thumbs.db
*.tmp
*.log

根据需要增减。某个文件夹不想同步，加一行路径就行。

4.5 提交并推送

1
2
3
4

git add .
git commit -m "初始提交"
git remote add origin https://github.com/你的用户名/my-project.git
git push -u origin master

推送时会要求输入：

• Username ：你的 GitHub 用户名
• Password ：粘贴你这台电脑的 token（粘贴时屏幕不显示字符，正常的，直接回车）

到这里，第一台电脑就搞定了。去 GitHub 网站上看看，你的文件应该全在上面了。

步骤 5：其他电脑下载项目

每一台其他电脑上执行：

5.1 配置加速 + 身份（和第一台一样）

1
2
3
4
5
6

# 加速
git config --global url."https://ghfast.top/https://github.com/".insteadOf "https://github.com/"

# 身份
git config --global user.email "你的邮箱"
git config --global user.name "你的用户名"

5.2 克隆仓库

1
2
3
4
5
6
7
8
9

# 进入你想放项目的父目录
cd ~/Documents    # Mac
cd "D:/workspace" # Windows（路径自己定）

# 克隆
git clone https://github.com/你的用户名/my-project.git

# 进入目录
cd my-project

克隆时会要求输入用户名和 token。

不想用仓库名当文件夹名？加第二个参数： git clone 地址 我想要的文件夹名

步骤 6：日常同步（每天就用这两条命令）

坐到任何一台电脑前 → 拉最新

1

git pull

做完工作准备离开 → 推到 GitHub

1
2
3

git add .
git commit -m "简单描述改了什么"
git push

就这么简单。不管你有 2 台电脑还是 10 台： 用之前拉，用完推 。

第三部分：易错点提醒（做完核心流程后再看）

以下是实际操作中容易踩坑的地方。如果你核心流程走通了，这些基本不会遇到。

1. commit 和 push 的区别

• git commit = 在 本地 打个快照，不需要网络，不需要 token
• git push = 把快照 推到 GitHub ，需要网络，需要 token

很多人以为 commit 了就同步了，其实还没。必须 push 才行。

2..git 是隐藏文件夹

git init 后看不到任何变化，因为它创建的 .git 是隐藏文件夹：

• Mac 查看： ls -a
• Windows PowerShell 查看： ls -Force

3. push 卡住没反应

可能原因：

• 网络问题 ： Ctrl+C 取消，检查是否需要配置镜像加速
• 在等输入密码 ：试试直接粘贴 token 再回车

4. 首次 push 后提示 This repository moved

仓库名大小写不一致。修正：

1

git remote set-url origin https://github.com/你的用户名/正确的仓库名.git

5. 出现 Author identity unknown

忘了设置身份信息：

1
2

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

6. 出现 LF will be replaced by CRLF 警告

正常。Windows 和 Mac 换行符不同，Git 自动处理，不影响文件内容。

7. Token 忘了复制

重新生成一个就行，旧的不用管。每台电脑的 token 建议存在备忘录里，标注好是哪台机器的。

8. origin 是什么

origin 是远程地址的别名，就像通讯录里给一个人存的名字。大家都约定俗成用 origin ，方便查教程。每个仓库的 origin 独立，互不影响。

9. 中文文件名和文件夹名

Git 完全支持中文，不影响。

10. Private 仓库别人能看到吗

不能。只有你自己能访问。

第四部分：进阶操作（核心流程会用之后再来看）

一、多个项目怎么管理

每个项目 = 一个独立的仓库 = 一套独立的 Git 流程，互不影响。

新建第二个项目：

1. GitHub 上新建空仓库（和第一次一样）
2. 在新项目的文件夹里：

1
2
3
4
5
6

cd "新项目文件夹路径"
git init
git add .
git commit -m "初始提交"
git remote add origin https://github.com/你的用户名/第二个项目.git
git push -u origin master

3. 其他电脑上： git clone 一次就行

每个项目各自有各自的 origin ，各自同步各自的。

二、本地项目换个位置

方式一：直接剪切（推荐）

剪切整个文件夹到新位置。.git 跟着走，配置不变，不用重新输 token。

方式二：删了重新 clone

删掉文件夹 → 重新 git clone → 要重新输一次用户名和 token。

三、处理冲突

两台电脑改了 同一个文件 ， git pull 时可能报冲突：

1
2
3
4
5
6
7
8
9
10
11
12
13

git pull

# 冲突文件里会看到标记：
# <<<<<<< HEAD
# 你刚改的内容
# =======
# 另一台电脑改的内容
# >>>>>>>

# 手动选择保留哪个，删掉标记符号，然后：
git add .
git commit -m "解决冲突"
git push

实际上冲突很少——不同机器创建的文件名通常不同，基本不会撞。

四、SSH 密钥方式（可选，替代 Token）

Token 够用了不用换。以后想换 SSH，随时一条命令切换：

1

git remote set-url origin git@github.com:你的用户名/my-project.git

然后每台机器生成密钥：

1
2
3
4
5

ssh-keygen -t ed25519 -C "你的邮箱"
# 三个问题全部回车跳过

cat ~/.ssh/id_ed25519.pub    # 复制输出内容
# 到 GitHub → Settings → SSH and GPG keys → New SSH key → 粘贴

五、设置别名（懒人必备）

每天敲三条命令嫌烦，设置别名后一条搞定：

1
2
3
4
5

# Mac → 编辑 ~/.zshrc
# Windows（Git Bash）→ 编辑 ~/.bashrc
alias gs="git status"
alias gp="git pull"
alias gpush="git add . && git commit -m 'sync' && git push"

保存后重启终端，以后：

• gp = 拉最新
• gpush = 一键推送
• gs = 查看当前状态

六、取消镜像加速

不需要加速了（比如换了网络环境）：

1

git config --global --unset url."https://ghfast.top/https://github.com/".insteadOf

速查表

引用链接

[1] https://git-scm.com

[2] https://github.com

微信扫一扫赞赏作者

AI落地指南 · 目录