以下是完整的从零开始步骤纯命令行操作全程按顺序执行即可。如果之前配过想彻底重来第一步先清理旧配置。一、清理旧配置仅重新开始需要如果你的笔记库之前配过 Git先完全重置本地仓库打开你的 Obsidian 笔记库根文件夹顶部菜单栏点「查看」→ 勾选「隐藏的项目」找到.git文件夹直接删除清空所有本地 Git 历史相当于全新开始二、安装 Git 客户端Git 是同步的底层工具必须先安装。下载安装包前往 Git 官网 Windows 下载页下载最新 64 位安装包安装双击安装程序全程保持默认选项一路点 Next 即可默认会自动配置系统环境变量CMD / PowerShell 都能直接用自带 Git Credential Manager后续可以实现免密推送验证安装按WinR输入cmd回车打开命令提示符输入命令git --version出现版本号如git version 2.47.0.windows.1即安装成功三、配置 Git 全局身份只需要配置一次以后所有本地仓库都用这个身份提交。在 CMD 中依次执行两条命令替换成你自己的 GitHub 信息git config --global user.name 你的GitHub用户名 git config --global user.email 你的GitHub绑定邮箱验证配置是否生效git config --list能看到你刚填写的 name 和 email 就说明配置成功。四、在 GitHub 创建私有空仓库你的笔记属于隐私内容必须创建私有仓库。登录 GitHub点击右上角→New repository填写信息Repository name仓库名比如obsidian-notesVisibility选择Private私有下方三个复选框Add a README、Add .gitignore、Choose a license全部不要勾选保持空仓库点击Create repository创建成功后复制页面上的HTTPS 仓库地址格式为https://github.com/你的用户名/obsidian-notes.git先保存好这个地址后面关联远程要用。五、生成 GitHub 个人访问令牌PATGitHub 已禁止使用账号密码推送代码必须用 PAT 令牌替代密码。GitHub 右上角头像 →Settings左侧拉到底部 →Developer settings左侧 →Personal access tokens→Tokens (classic)点击Generate new token→Generate new token (classic)配置参数Note填写备注如Obsidian SyncExpiration选择有效期建议90 daysSelect scopes只勾选repo这一项仓库完整读写权限拉到底部点击Generate token立刻复制生成的 token 字符串并保存页面关闭后无法再次查看。六、初始化本地笔记库并首次推送这是核心步骤把你的本地笔记库和 GitHub 仓库关联起来。步骤 1快速打开命令行到笔记库目录新手最友好的方式不用手动输路径打开你的 Obsidian 笔记库根文件夹能看到所有笔记和.obsidian文件夹的那一层点击顶部地址栏全选原有路径直接输入cmd按回车弹出的 CMD 窗口会自动定位到当前目录步骤 2初始化本地 Git 仓库git init步骤 3创建 .gitignore 文件必做Windows 资源管理器直接创建容易踩后缀名的坑用命令行创建最稳妥notepad .gitignore弹出记事本后粘贴以下内容然后保存关闭# Obsidian 缓存与工作区 .obsidian/workspace .obsidian/workspace.json .obsidian/cache # 系统垃圾文件 .DS_Store Thumbs.db Desktop.ini # 临时文件 *.tmp *.swp *.log步骤 4暂存所有文件并首次提交# 将所有文件加入暂存区 git add . # 提交到本地仓库引号内是提交备注可自定义 git commit -m 首次提交初始化笔记库步骤 5关联远程仓库并推送到 GitHub把下面命令里的地址换成你第四步复制的 GitHub 仓库 HTTPS 地址# 重命名主分支为 main和 GitHub 保持一致 git branch -M main # 关联远程仓库 git remote add origin https://github.com/你的用户名/obsidian-notes.git # 首次推送到 GitHub git push -u origin main执行 push 后会弹出 Git Credential Manager 登录窗口用户名输入你的 GitHub 用户名密码输入第五步生成的 PAT 令牌确认后系统会自动保存凭证以后推送无需重复输入推送成功后刷新 GitHub 仓库页面就能看到你的所有笔记文件了。七、日常同步命令以后每次同步都在笔记库目录打开 CMD执行对应命令即可。1. 本地笔记 → 上传到 GitHub提交 推送git add . git commit -m 更新笔记内容 git push引号内的备注可以自定义比如补充XX主题笔记、整理文件结构。2. GitHub → 下载到本地拉取更新换电脑使用、或者另一台设备更新过笔记打开笔记前先执行git pull3. 查看当前状态可选git status可以看到哪些文件被修改、有没有待提交的内容方便确认状态。八、Windows 一键同步脚本懒人必备每次输三条命令太麻烦可以写一个批处理脚本双击就能自动完成提交 推送。在笔记库根目录新建文本文档粘贴以下内容echo off cd /d %~dp0 git add . git commit -m 自动更新 %date% %time% git push echo. echo 同步完成按任意键关闭 pause nul保存文件重命名为同步.bat注意后缀是.bat不是.txt以后双击这个文件就能一键完成全部同步流程九、常见问题排查提示 git 不是内部或外部命令说明 Git 环境变量未生效先重启电脑仍无效则重装 Git安装时保持默认 PATH 选项推送失败提示认证失败检查 PAT 是否复制正确、是否勾选了 repo 权限、是否过期可打开「控制面板 → 凭据管理器 → Windows 凭据」找到 GitHub 相关条目删除后重新输入 PAT执行 pull 提示文件冲突打开冲突文件找到标记的区域手动保留需要的内容删除所有标记符号重新执行git add .→git commit→git push即可 Windows 从零开始：CLI 方式配置 GitHub 同步 Obsidian
以下是完整的从零开始步骤纯命令行操作全程按顺序执行即可。如果之前配过想彻底重来第一步先清理旧配置。一、清理旧配置仅重新开始需要如果你的笔记库之前配过 Git先完全重置本地仓库打开你的 Obsidian 笔记库根文件夹顶部菜单栏点「查看」→ 勾选「隐藏的项目」找到.git文件夹直接删除清空所有本地 Git 历史相当于全新开始二、安装 Git 客户端Git 是同步的底层工具必须先安装。下载安装包前往 Git 官网 Windows 下载页下载最新 64 位安装包安装双击安装程序全程保持默认选项一路点 Next 即可默认会自动配置系统环境变量CMD / PowerShell 都能直接用自带 Git Credential Manager后续可以实现免密推送验证安装按WinR输入cmd回车打开命令提示符输入命令git --version出现版本号如git version 2.47.0.windows.1即安装成功三、配置 Git 全局身份只需要配置一次以后所有本地仓库都用这个身份提交。在 CMD 中依次执行两条命令替换成你自己的 GitHub 信息git config --global user.name 你的GitHub用户名 git config --global user.email 你的GitHub绑定邮箱验证配置是否生效git config --list能看到你刚填写的 name 和 email 就说明配置成功。四、在 GitHub 创建私有空仓库你的笔记属于隐私内容必须创建私有仓库。登录 GitHub点击右上角→New repository填写信息Repository name仓库名比如obsidian-notesVisibility选择Private私有下方三个复选框Add a README、Add .gitignore、Choose a license全部不要勾选保持空仓库点击Create repository创建成功后复制页面上的HTTPS 仓库地址格式为https://github.com/你的用户名/obsidian-notes.git先保存好这个地址后面关联远程要用。五、生成 GitHub 个人访问令牌PATGitHub 已禁止使用账号密码推送代码必须用 PAT 令牌替代密码。GitHub 右上角头像 →Settings左侧拉到底部 →Developer settings左侧 →Personal access tokens→Tokens (classic)点击Generate new token→Generate new token (classic)配置参数Note填写备注如Obsidian SyncExpiration选择有效期建议90 daysSelect scopes只勾选repo这一项仓库完整读写权限拉到底部点击Generate token立刻复制生成的 token 字符串并保存页面关闭后无法再次查看。六、初始化本地笔记库并首次推送这是核心步骤把你的本地笔记库和 GitHub 仓库关联起来。步骤 1快速打开命令行到笔记库目录新手最友好的方式不用手动输路径打开你的 Obsidian 笔记库根文件夹能看到所有笔记和.obsidian文件夹的那一层点击顶部地址栏全选原有路径直接输入cmd按回车弹出的 CMD 窗口会自动定位到当前目录步骤 2初始化本地 Git 仓库git init步骤 3创建 .gitignore 文件必做Windows 资源管理器直接创建容易踩后缀名的坑用命令行创建最稳妥notepad .gitignore弹出记事本后粘贴以下内容然后保存关闭# Obsidian 缓存与工作区 .obsidian/workspace .obsidian/workspace.json .obsidian/cache # 系统垃圾文件 .DS_Store Thumbs.db Desktop.ini # 临时文件 *.tmp *.swp *.log步骤 4暂存所有文件并首次提交# 将所有文件加入暂存区 git add . # 提交到本地仓库引号内是提交备注可自定义 git commit -m 首次提交初始化笔记库步骤 5关联远程仓库并推送到 GitHub把下面命令里的地址换成你第四步复制的 GitHub 仓库 HTTPS 地址# 重命名主分支为 main和 GitHub 保持一致 git branch -M main # 关联远程仓库 git remote add origin https://github.com/你的用户名/obsidian-notes.git # 首次推送到 GitHub git push -u origin main执行 push 后会弹出 Git Credential Manager 登录窗口用户名输入你的 GitHub 用户名密码输入第五步生成的 PAT 令牌确认后系统会自动保存凭证以后推送无需重复输入推送成功后刷新 GitHub 仓库页面就能看到你的所有笔记文件了。七、日常同步命令以后每次同步都在笔记库目录打开 CMD执行对应命令即可。1. 本地笔记 → 上传到 GitHub提交 推送git add . git commit -m 更新笔记内容 git push引号内的备注可以自定义比如补充XX主题笔记、整理文件结构。2. GitHub → 下载到本地拉取更新换电脑使用、或者另一台设备更新过笔记打开笔记前先执行git pull3. 查看当前状态可选git status可以看到哪些文件被修改、有没有待提交的内容方便确认状态。八、Windows 一键同步脚本懒人必备每次输三条命令太麻烦可以写一个批处理脚本双击就能自动完成提交 推送。在笔记库根目录新建文本文档粘贴以下内容echo off cd /d %~dp0 git add . git commit -m 自动更新 %date% %time% git push echo. echo 同步完成按任意键关闭 pause nul保存文件重命名为同步.bat注意后缀是.bat不是.txt以后双击这个文件就能一键完成全部同步流程九、常见问题排查提示 git 不是内部或外部命令说明 Git 环境变量未生效先重启电脑仍无效则重装 Git安装时保持默认 PATH 选项推送失败提示认证失败检查 PAT 是否复制正确、是否勾选了 repo 权限、是否过期可打开「控制面板 → 凭据管理器 → Windows 凭据」找到 GitHub 相关条目删除后重新输入 PAT执行 pull 提示文件冲突打开冲突文件找到标记的区域手动保留需要的内容删除所有标记符号重新执行git add .→git commit→git push即可