1. 先把需求想透笔记备份到底在解决什么问题笔记这东西写的时候不觉得丢的时候要命。我自己踩过一次坑本地一个记录了大半年的技术笔记目录因为一次误操作被整体覆盖回收站里也没有那种感觉比丢钱还难受。从那之后我就一直在琢磨能不能让备份这件事自动发生而不是靠我每周想起来手动复制一次。人靠自觉是靠不住的尤其是写笔记的人注意力都在内容上谁会记得每周五下午去同步一次文件夹。所以这个项目的核心诉求其实很朴素在 Windows 上把本地笔记目录自动、增量地备份到一个可靠的远端仓库全程不需要人工干预出问题时能快速回滚到任意历史版本。这里的关键词有三个——Windows、Git、自动备份。Windows 是环境约束Git 是手段自动是灵魂。很多人用 Git 只是提交代码但 Git 本质上是一个带完整历史的内容快照工具任何文本类的东西都能管笔记天然适合。为什么选 Git 而不是网盘同步、不是简单的定时复制这是我在方案选型阶段想得最久的一点。网盘同步的问题在于它是镜像逻辑本地删了云端也删误删照样同步过去而且历史版本通常只保留很短时间。定时复制则是全量覆盖占用空间大还看不出每次改了什么。Git 的提交是增量的、带时间戳和提交信息的每一次备份都是一个不可变的快照回滚成本极低。说白了我要的不是同步而是可追溯的版本存档这两者的差别在出事故那天才会体现出来。适合谁看这份记录我觉得有三类人最对口一是长期用 Markdown 或纯文本写笔记的人内容本身是文本Git 管理起来毫无压力二是已经装了 Git 但不满足于只在写代码时用它的人想把这套工具的价值榨干三是对数据安全感要求比较高、又不愿意花钱买订阅服务的人。如果你用的是大量二进制附件比如几十 G 的图片视频混在笔记里那这套方案需要额外处理后面会讲到。至于完全没接触过命令行的朋友也能跟着做因为真正要写的命令就几条剩下的都是配置。还有一点得先说清楚这套方案的可靠性取决于你选的那个远端仓库服务是否稳定以及你对 Git 的基本操作是否熟悉。我不会承诺永不丢失那是骗人的。我能保证的是在你本地硬盘没彻底报废、远端服务正常的前提下你的笔记每一天都有据可查。这个预期摆正了后面的操作才有意义。2. 方案整体设计与取舍逻辑2.1 为什么用本地仓库 定时提交 远端推送三段式我最终落地的结构是三段式的本地笔记目录本身就是一个 Git 仓库一个脚本负责把当天所有改动提交成一个 commit另一个机制负责把本地提交推送到远端。拆成三段而不是一步到位是有原因的。如果每次改动都直接提交推送commit 会碎得没法看一天几十条提交历史记录变成噪音回滚的时候根本找不到哪个是当天结束时的状态。而先本地提交、再批量推送等于给历史做了一次整理每次提交就是一个清晰的时间节点。另一个考虑是容错。本地提交几乎不会失败它只依赖磁盘推送才依赖网络。把两者分开意味着即使某天网络抽风、远端服务临时不可用你的本地历史照样完整记录着第二天补推就行。我见过有人把提交和推送捆在一个流程里网络一断当天的记录就断了这种设计不够稳。提示本地提交是记录远端推送是异地存档两者的可靠性等级不同不要混为一谈。2.2 触发方式的选择计划任务还是文件监听自动化的触发方式我对比过两种Windows 任务计划程序按时间触发和文件系统监听有改动就触发。文件监听听起来更实时但实际用下来我更推荐计划任务。原因是笔记的写入往往是连续的——你打一段字就触发一次提交几分钟内能产生几十个 commit历史彻底乱掉而且监听工具常驻内存偶尔会和编辑器抢文件锁尤其是某些编辑器保存时会先写临时文件再替换监听器容易抓到半截内容。计划任务则简单粗暴每天固定时间跑一次把那一天的所有改动打包成一个提交。这里有个细节任务计划程序默认在用户未登录时也能运行但 Git 推送需要凭据凭据的存储位置和登录会话相关这一点后面配置时容易踩坑我会单独讲。总的来说按时间触发更可控、更容易排查出问题时看日志一目了然。2.3 仓库放哪、备份放哪目录结构的讲究目录结构上我做了明确分工笔记正文放在一个独立目录里Git 仓库的元数据.git 文件夹就跟着笔记目录走远端仓库则放在一个和本地完全无关的存储位置。为什么不建议把笔记目录塞进某个已经很大的父仓库因为 Git 追踪的是整个仓库的文件父仓库里如果有大量无关文件和构建产物每次提交的状态判断都会变慢而且提交历史会混在一起回滚时容易误伤。还有一个实践中的取舍要不要对笔记里的敏感内容做过滤。有些笔记会记录账号备忘、内部信息之类的东西推到远端之前最好确认一下。我的做法是在仓库根目录放一个 .gitignore把明确不想上传的目录排除掉同时在第一次推送前用 git status 完整看一遍待提交清单确认没有意外内容。这一步花五分钟能省掉后面很多麻烦。方案历史可追溯空间占用误删可恢复配置复杂度适用场景网盘同步弱版本保留期短中有限低多设备实时同步定时全量复制无高可恢复当日低简单冷备手动压缩打包无中可恢复低不定期归档Git 本地远端强完整历史低增量任意版本中文本笔记长期存档这张表是我当时做决策时列的现在回看依然成立。Git 方案的配置成本是唯一劣势但它是一次性成本配好之后就不再操心这个投入产出比很划算。3. 环境准备与仓库初始化的关键细节3.1 Git 安装时那几个容易被忽略的选项Windows 上装 Git一路下一步也能用但有两个选项建议手动确认。第一个是默认分支名新版本安装器会问你是用 master 还是自定义名称这个不影响功能但团队协作时统一一下比较好个人用随意。第二个是行尾换行符转换安装器里有检出时转换为 Windows 风格、提交时转换为 Unix 风格这个选项对于纯笔记场景我建议选按原样检出、按原样提交也就是不做转换。原因是笔记里如果混了代码片段自动转换可能让 diff 变得很难看本来只改了一行显示成整个文件都变了。装完之后第一件事是配置身份这是提交记录里的署名不是账号密码git config --global user.name 你的名字或代号 git config --global user.email 你的邮箱 git config --global core.autocrlf false第三条就是关掉自动换行转换和安装时的选择对应。另外建议顺手设置一下默认编辑器不然某些操作会弹出你完全不熟的编辑器让你输入信息git config --global core.editor notepad用记事本虽然土但至少你认识它不会卡在一个不知道怎么退出的界面里。这是我第一次配置时真实卡住过的地方说起来有点丢人但确实常见。3.2 初始化仓库时的第一个提交很关键进入笔记目录执行初始化cd /d D:\Notes git init git add -A git commit -m init: 笔记库首次纳入版本管理这里有个经验第一次提交一定要把当时的所有文件都包含进去形成一个完整的基线。有些人图省事只提交一部分后面再补结果历史里出现第一次提交不完整的尴尬状态回滚到最初版本时内容缺失。基线完整后面才有意义。初始化完立刻验证一下追踪状态git status git log --onelinegit status应该显示工作区干净git log应该只有一条记录。如果 status 里冒出一堆你没预期的文件比如编辑器自动生成的缓存、临时文件先别急着提交把它们加进 .gitignore。我在一个目录里发现过自动生成的索引缓存文件每次打开笔记都会变那种文件提交进去只会制造无意义的变更记录。3.3 .gitignore 要写在第 0 天而不是第 100 天这是很多人吃亏的地方仓库跑了半年突然发现里面混进了几百兆的临时文件想把它们从历史里剔除就非常麻烦了得重写历史。所以 .gitignore 一定要在第一次提交之前就写好。针对笔记场景我通常会排除这几类# 编辑器与系统缓存 .obsidian/workspace* *.tmp *.swp Thumbs.db desktop.ini # 临时导出与回收站 /_trash/ /_export/ # 大体积附件目录按需 /attachments/video/注意斜杠开头的写法表示只匹配仓库根目录下的路径避免误伤子目录里同名的正常文件。这个细节看似小但确实有人因为写了trash/而把某个正经子目录也排除掉了排查半天才发现。提示如果某个目录你拿不准要不要排除先别排除提交之后用git log --stat看看它的变更频率和体积再决定。4. 自动备份脚本的编写与参数控制4.1 脚本主体提交、推送、日志三件事脚本我写在仓库外面放在一个固定路径比如D:\Scripts\notes-backup.bat。内容不长但每一行都有用途echo off chcp 65001 nul set REPOD:\Notes set LOGD:\Scripts\backup.log cd /d %REPO% echo [%date% %time%] 开始备份 %LOG% git add -A %LOG% 21 git diff --cached --quiet if %errorlevel%0 ( echo [%date% %time%] 无变更跳过提交 %LOG% goto PUSH ) git commit -m auto: %date% %time% 自动备份 %LOG% 21 :PUSH git push origin main %LOG% 21 echo [%date% %time%] 推送完成返回码 %errorlevel% %LOG%chcp 65001是为了让中文提交信息不乱码这个在中文系统上非常必要不加的话日志里全是问号。git diff --cached --quiet那一行的作用是判断暂存区有没有实际改动如果没有就不产生空提交——空提交虽然无害但日积月累会让历史里塞满无意义的节点。4.2 提交信息的设计为将来回滚服务提交信息我固定用auto: 日期 时间 自动备份这种格式。为什么不写得更有描述性因为是自动的程序不知道你今天写了什么。但固定格式有个好处将来要查找某个时间点的状态可以直接按日期搜索git log --oneline --since2024-05-01 --until2024-05-31如果你希望提交信息更有信息量可以在脚本里加一步把当天的改动文件名摘出来拼进信息里git diff --cached --name-only temp_changes.txt不过说实话用久了你会发现没必要因为git show随时能看到每个提交改了哪些文件。提交信息保持简洁反而好维护。4.3 推送凭据的持久化是这套方案最容易翻车的环节自动脚本在后台跑没有交互界面所以凭据必须提前存好。这里我踩过的坑最值得说。现代 Git 在 Windows 上默认用凭据管理器Credential Manager保存 HTTPS 的账号信息你在命令行第一次推送时输入一次之后就不再问。但问题在于任务计划程序以无论用户是否登录都运行的方式执行时运行上下文可能取不到当前用户凭据库里的那份数据表现就是日志里出现认证失败。我的处理办法是改用 SSH 方式并确保密钥没有设置口令或者把口令交给代理管理。生成密钥ssh-keygen -t ed25519 -C notes-backup一路回车不要设 passphrase因为自动任务没机会输入。然后把公钥配置到远端仓库服务的账户里。这种方式的好处是认证不依赖交互也不会过期。代价是这台机器上的密钥一旦泄露风险较大所以这台机器本身的安全习惯要跟上。配好之后先手动推一次验证git remote add origin 你的仓库地址 git push -u origin main第一次成功后脚本的推送就能顺利执行了。如果用的是 HTTPS 且坚持要让计划任务在未登录状态下运行那就要确认凭据管理器的存储位置对那个运行上下文可见这个调试起来比较费劲我不太推荐。认证方式自动任务可用性配置难度安全注意点HTTPS 凭据管理器登录状态下可用低依赖用户会话HTTPS 凭据写入配置可用中明文风险高SSH 密钥无口令可用中保护本机安全SSH 密钥 代理可用较高需常驻代理5. 让备份真正自动跑起来5.1 任务计划程序的配置要点打开任务计划程序创建基本任务触发器选每天时间定在晚上你基本不写笔记的时段比如 23:30。操作选启动程序程序填cmd.exe参数填/c D:\Scripts\notes-backup.bat。这里有个细节直接在程序或脚本里填 bat 文件路径有时会闪退用 cmd 包一层最稳。关键设置藏在任务属性里常规页签勾选不管用户是否登录都要运行这样锁屏状态下也会执行同一页签勾选使用最高权限运行避免某些目录权限问题条件页签里把只有在计算机使用交流电源时才启动取消掉笔记本用电池时也要备份设置页签里勾选如果任务失败按以下频率重新启动间隔 5 分钟尝试 3 次应对偶发网络抖动。这几个选项看起来琐碎但每一个都对应过实际故障。尤其是电源条件那条我见过笔记本拔了电源之后备份静默停了一周的情况日志一条记录都没有很难发现。5.2 验证自动化是否真的生效配置完之后千万别以为就完事了。我的验证方法是改一个笔记文件手动运行一次任务右键任务点运行然后看三样东西——git log有没有新提交、远端仓库页面有没有新推送、日志文件有没有记录。三样都对上才算通了。之后连续观察两三天看每天是否按时产生提交。如果某天断了先查日志末尾的返回码。返回码非 0 就把对应那段命令单独拿出来在命令行里跑很快能定位。我自己的经验是九成的失败都是认证问题或网络问题剩下的一成是路径里有空格没加引号。5.3 补一份手动兜底清单自动化再稳也不该成为唯一路径。我给自己留了个备用操作流程写在笔记库根目录的 README 里打开命令行进入笔记目录执行git status看当前状态执行git add -A git commit -m manual: 手动备份执行git push。这四步在任何时候都能顶上去。另外我还会定期大概每季度做一次恢复演练——随便挑一个两周前的提交把它检出到一个临时目录确认内容完整可读。听起来多余但真出事时你才会庆幸自己练过。注意恢复演练千万别在笔记主目录里直接 checkout 旧提交那样会把当前文件改回旧版。正确做法是git worktree add到另一个目录或者干脆 clone 一份到别处验证。6. 常见故障与排查实录6.1 中文提交信息变问号症状是日志里提交信息全是????。原因是批处理文件的编码和当前代码页不匹配。解决方式是脚本开头加chcp 65001并且把 bat 文件本身保存为 UTF-8 编码不带 BOM。如果还不行检查一下 Git 的i18n.commitEncoding配置设为 utf-8。6.2 推送一直在认证环节失败按重要性排序排查先手动执行git push看是否正常正常则说明是任务运行环境的问题再确认任务是否勾选了不管用户是否登录都运行这个模式下凭据库往往取不到最后考虑换 SSH 方式。不要急着清空凭据管理器那会让你连手动推送都要重新输密码。6.3 仓库越来越大提交变慢文本笔记一般不会但如果混进了图片附件就有可能。用下面这条命令找出体积最大的历史对象git rev-list --objects --all | git cat-file --batch-check%(objecttype) %(objectname) %(objectsize) %(rest) | sort -k 3 -n -r | head -20如果发现某个大文件是不小心提交的用git filter-repo从历史里清除然后强推。注意这是破坏性操作执行前先完整备份本地仓库。更省事的办法是防患于未然把附件目录写进 .gitignore。6.4 计划任务显示上次运行结果 0x1返回码 1 通常意味着脚本里有命令失败了但由于重定向只记录输出不记录每一步的返回码直接看日志不容易定位。可以在脚本每个关键命令后面加一行echo step N rc%errorlevel%跑一次就知道断在哪。我自己的经验最常见的是 cd 目录不存在盘符变了或目录被重命名。6.5 编辑器正在写文件时被提交偶尔会出现某个文件内容不完整就被提交了。原因是计划任务恰好撞上了编辑器的保存瞬间。概率很低但确实发生过。缓解办法是把任务时间放在你明确不会写作的时段比如凌晨或者在脚本开头加个小延时等两秒再执行git add。真要严谨可以在提交前检查文件锁定状态不过对笔记场景有点过度设计了。故障现象首要排查点快速处理提交信息乱码代码页与文件编码加 chcp 65001文件存 UTF-8认证失败运行上下文与凭据可见性改 SSH 或改任务运行模式无新提交但有改动脚本是否执行到 add 之前看日志断点检查路径仓库膨胀是否误提交大文件查历史对象清理或用忽略推送成功但远端没变分支名是否一致确认 main/master 与远端对应7. 长期维护中的几条实战心得7.1 别把备份和同步混着做我一开始贪心想让笔记在多台机器上实时同步结果本地仓库和同步工具打架出现文件被改回旧版的情况。后来想明白了Git 负责存档同步工具负责分发两者各管一段最好不要让同步工具去同步 .git 目录。现在的做法是每台机器独立备份到自己的分支需要合并时手动处理麻烦一点但不会互相破坏。7.2 提交信息里别写敏感内容自动提交的信息里只有时间这是有意的。手动补提交时也不要在信息里写整理账号笔记这类描述因为你不知道远端仓库的可见性将来会怎么变。习惯从第一天养成比后来改历史容易得多。7.3 定期把远端仓库再备份一份远端不等于绝对安全。我的做法是每个月把远端仓库完整克隆一份到一块离线硬盘上放在抽屉里。听起来原始但这是唯一不依赖任何在线服务的兜底。克隆下来的是完整历史出任何问题都能从这份离线副本恢复。git clone --mirror 远端地址 D:\OfflineBackup\notes.git--mirror会连同所有分支和标签一起拿下来比普通 clone 更完整。7.4 恢复时的正确姿势真要回滚某天的内容不要脑子里想着整个仓库回到过去而应该先找出那一天对应的提交然后只把需要的文件取出来git log --oneline --until2024-05-20 23:59 git checkout commit -- 某个文件.md这样只影响指定文件其他内容保持现状风险最小。整个仓库硬回滚是最后手段用之前务必用git worktree或另 clone 一份做保险。我自己第一次做恢复时就是把整个分支 reset 了结果丢掉了当天更晚的一些改动虽然损失不大但那个教训记到现在。把这套流程跑顺之后备份这件事基本从我脑子里消失了它只是每天夜里默默发生一次。偶尔翻日志看到连续的记录那种踏实感比任何提醒都管用。
1. 先把需求想透笔记备份到底在解决什么问题笔记这东西写的时候不觉得丢的时候要命。我自己踩过一次坑本地一个记录了大半年的技术笔记目录因为一次误操作被整体覆盖回收站里也没有那种感觉比丢钱还难受。从那之后我就一直在琢磨能不能让备份这件事自动发生而不是靠我每周想起来手动复制一次。人靠自觉是靠不住的尤其是写笔记的人注意力都在内容上谁会记得每周五下午去同步一次文件夹。所以这个项目的核心诉求其实很朴素在 Windows 上把本地笔记目录自动、增量地备份到一个可靠的远端仓库全程不需要人工干预出问题时能快速回滚到任意历史版本。这里的关键词有三个——Windows、Git、自动备份。Windows 是环境约束Git 是手段自动是灵魂。很多人用 Git 只是提交代码但 Git 本质上是一个带完整历史的内容快照工具任何文本类的东西都能管笔记天然适合。为什么选 Git 而不是网盘同步、不是简单的定时复制这是我在方案选型阶段想得最久的一点。网盘同步的问题在于它是镜像逻辑本地删了云端也删误删照样同步过去而且历史版本通常只保留很短时间。定时复制则是全量覆盖占用空间大还看不出每次改了什么。Git 的提交是增量的、带时间戳和提交信息的每一次备份都是一个不可变的快照回滚成本极低。说白了我要的不是同步而是可追溯的版本存档这两者的差别在出事故那天才会体现出来。适合谁看这份记录我觉得有三类人最对口一是长期用 Markdown 或纯文本写笔记的人内容本身是文本Git 管理起来毫无压力二是已经装了 Git 但不满足于只在写代码时用它的人想把这套工具的价值榨干三是对数据安全感要求比较高、又不愿意花钱买订阅服务的人。如果你用的是大量二进制附件比如几十 G 的图片视频混在笔记里那这套方案需要额外处理后面会讲到。至于完全没接触过命令行的朋友也能跟着做因为真正要写的命令就几条剩下的都是配置。还有一点得先说清楚这套方案的可靠性取决于你选的那个远端仓库服务是否稳定以及你对 Git 的基本操作是否熟悉。我不会承诺永不丢失那是骗人的。我能保证的是在你本地硬盘没彻底报废、远端服务正常的前提下你的笔记每一天都有据可查。这个预期摆正了后面的操作才有意义。2. 方案整体设计与取舍逻辑2.1 为什么用本地仓库 定时提交 远端推送三段式我最终落地的结构是三段式的本地笔记目录本身就是一个 Git 仓库一个脚本负责把当天所有改动提交成一个 commit另一个机制负责把本地提交推送到远端。拆成三段而不是一步到位是有原因的。如果每次改动都直接提交推送commit 会碎得没法看一天几十条提交历史记录变成噪音回滚的时候根本找不到哪个是当天结束时的状态。而先本地提交、再批量推送等于给历史做了一次整理每次提交就是一个清晰的时间节点。另一个考虑是容错。本地提交几乎不会失败它只依赖磁盘推送才依赖网络。把两者分开意味着即使某天网络抽风、远端服务临时不可用你的本地历史照样完整记录着第二天补推就行。我见过有人把提交和推送捆在一个流程里网络一断当天的记录就断了这种设计不够稳。提示本地提交是记录远端推送是异地存档两者的可靠性等级不同不要混为一谈。2.2 触发方式的选择计划任务还是文件监听自动化的触发方式我对比过两种Windows 任务计划程序按时间触发和文件系统监听有改动就触发。文件监听听起来更实时但实际用下来我更推荐计划任务。原因是笔记的写入往往是连续的——你打一段字就触发一次提交几分钟内能产生几十个 commit历史彻底乱掉而且监听工具常驻内存偶尔会和编辑器抢文件锁尤其是某些编辑器保存时会先写临时文件再替换监听器容易抓到半截内容。计划任务则简单粗暴每天固定时间跑一次把那一天的所有改动打包成一个提交。这里有个细节任务计划程序默认在用户未登录时也能运行但 Git 推送需要凭据凭据的存储位置和登录会话相关这一点后面配置时容易踩坑我会单独讲。总的来说按时间触发更可控、更容易排查出问题时看日志一目了然。2.3 仓库放哪、备份放哪目录结构的讲究目录结构上我做了明确分工笔记正文放在一个独立目录里Git 仓库的元数据.git 文件夹就跟着笔记目录走远端仓库则放在一个和本地完全无关的存储位置。为什么不建议把笔记目录塞进某个已经很大的父仓库因为 Git 追踪的是整个仓库的文件父仓库里如果有大量无关文件和构建产物每次提交的状态判断都会变慢而且提交历史会混在一起回滚时容易误伤。还有一个实践中的取舍要不要对笔记里的敏感内容做过滤。有些笔记会记录账号备忘、内部信息之类的东西推到远端之前最好确认一下。我的做法是在仓库根目录放一个 .gitignore把明确不想上传的目录排除掉同时在第一次推送前用 git status 完整看一遍待提交清单确认没有意外内容。这一步花五分钟能省掉后面很多麻烦。方案历史可追溯空间占用误删可恢复配置复杂度适用场景网盘同步弱版本保留期短中有限低多设备实时同步定时全量复制无高可恢复当日低简单冷备手动压缩打包无中可恢复低不定期归档Git 本地远端强完整历史低增量任意版本中文本笔记长期存档这张表是我当时做决策时列的现在回看依然成立。Git 方案的配置成本是唯一劣势但它是一次性成本配好之后就不再操心这个投入产出比很划算。3. 环境准备与仓库初始化的关键细节3.1 Git 安装时那几个容易被忽略的选项Windows 上装 Git一路下一步也能用但有两个选项建议手动确认。第一个是默认分支名新版本安装器会问你是用 master 还是自定义名称这个不影响功能但团队协作时统一一下比较好个人用随意。第二个是行尾换行符转换安装器里有检出时转换为 Windows 风格、提交时转换为 Unix 风格这个选项对于纯笔记场景我建议选按原样检出、按原样提交也就是不做转换。原因是笔记里如果混了代码片段自动转换可能让 diff 变得很难看本来只改了一行显示成整个文件都变了。装完之后第一件事是配置身份这是提交记录里的署名不是账号密码git config --global user.name 你的名字或代号 git config --global user.email 你的邮箱 git config --global core.autocrlf false第三条就是关掉自动换行转换和安装时的选择对应。另外建议顺手设置一下默认编辑器不然某些操作会弹出你完全不熟的编辑器让你输入信息git config --global core.editor notepad用记事本虽然土但至少你认识它不会卡在一个不知道怎么退出的界面里。这是我第一次配置时真实卡住过的地方说起来有点丢人但确实常见。3.2 初始化仓库时的第一个提交很关键进入笔记目录执行初始化cd /d D:\Notes git init git add -A git commit -m init: 笔记库首次纳入版本管理这里有个经验第一次提交一定要把当时的所有文件都包含进去形成一个完整的基线。有些人图省事只提交一部分后面再补结果历史里出现第一次提交不完整的尴尬状态回滚到最初版本时内容缺失。基线完整后面才有意义。初始化完立刻验证一下追踪状态git status git log --onelinegit status应该显示工作区干净git log应该只有一条记录。如果 status 里冒出一堆你没预期的文件比如编辑器自动生成的缓存、临时文件先别急着提交把它们加进 .gitignore。我在一个目录里发现过自动生成的索引缓存文件每次打开笔记都会变那种文件提交进去只会制造无意义的变更记录。3.3 .gitignore 要写在第 0 天而不是第 100 天这是很多人吃亏的地方仓库跑了半年突然发现里面混进了几百兆的临时文件想把它们从历史里剔除就非常麻烦了得重写历史。所以 .gitignore 一定要在第一次提交之前就写好。针对笔记场景我通常会排除这几类# 编辑器与系统缓存 .obsidian/workspace* *.tmp *.swp Thumbs.db desktop.ini # 临时导出与回收站 /_trash/ /_export/ # 大体积附件目录按需 /attachments/video/注意斜杠开头的写法表示只匹配仓库根目录下的路径避免误伤子目录里同名的正常文件。这个细节看似小但确实有人因为写了trash/而把某个正经子目录也排除掉了排查半天才发现。提示如果某个目录你拿不准要不要排除先别排除提交之后用git log --stat看看它的变更频率和体积再决定。4. 自动备份脚本的编写与参数控制4.1 脚本主体提交、推送、日志三件事脚本我写在仓库外面放在一个固定路径比如D:\Scripts\notes-backup.bat。内容不长但每一行都有用途echo off chcp 65001 nul set REPOD:\Notes set LOGD:\Scripts\backup.log cd /d %REPO% echo [%date% %time%] 开始备份 %LOG% git add -A %LOG% 21 git diff --cached --quiet if %errorlevel%0 ( echo [%date% %time%] 无变更跳过提交 %LOG% goto PUSH ) git commit -m auto: %date% %time% 自动备份 %LOG% 21 :PUSH git push origin main %LOG% 21 echo [%date% %time%] 推送完成返回码 %errorlevel% %LOG%chcp 65001是为了让中文提交信息不乱码这个在中文系统上非常必要不加的话日志里全是问号。git diff --cached --quiet那一行的作用是判断暂存区有没有实际改动如果没有就不产生空提交——空提交虽然无害但日积月累会让历史里塞满无意义的节点。4.2 提交信息的设计为将来回滚服务提交信息我固定用auto: 日期 时间 自动备份这种格式。为什么不写得更有描述性因为是自动的程序不知道你今天写了什么。但固定格式有个好处将来要查找某个时间点的状态可以直接按日期搜索git log --oneline --since2024-05-01 --until2024-05-31如果你希望提交信息更有信息量可以在脚本里加一步把当天的改动文件名摘出来拼进信息里git diff --cached --name-only temp_changes.txt不过说实话用久了你会发现没必要因为git show随时能看到每个提交改了哪些文件。提交信息保持简洁反而好维护。4.3 推送凭据的持久化是这套方案最容易翻车的环节自动脚本在后台跑没有交互界面所以凭据必须提前存好。这里我踩过的坑最值得说。现代 Git 在 Windows 上默认用凭据管理器Credential Manager保存 HTTPS 的账号信息你在命令行第一次推送时输入一次之后就不再问。但问题在于任务计划程序以无论用户是否登录都运行的方式执行时运行上下文可能取不到当前用户凭据库里的那份数据表现就是日志里出现认证失败。我的处理办法是改用 SSH 方式并确保密钥没有设置口令或者把口令交给代理管理。生成密钥ssh-keygen -t ed25519 -C notes-backup一路回车不要设 passphrase因为自动任务没机会输入。然后把公钥配置到远端仓库服务的账户里。这种方式的好处是认证不依赖交互也不会过期。代价是这台机器上的密钥一旦泄露风险较大所以这台机器本身的安全习惯要跟上。配好之后先手动推一次验证git remote add origin 你的仓库地址 git push -u origin main第一次成功后脚本的推送就能顺利执行了。如果用的是 HTTPS 且坚持要让计划任务在未登录状态下运行那就要确认凭据管理器的存储位置对那个运行上下文可见这个调试起来比较费劲我不太推荐。认证方式自动任务可用性配置难度安全注意点HTTPS 凭据管理器登录状态下可用低依赖用户会话HTTPS 凭据写入配置可用中明文风险高SSH 密钥无口令可用中保护本机安全SSH 密钥 代理可用较高需常驻代理5. 让备份真正自动跑起来5.1 任务计划程序的配置要点打开任务计划程序创建基本任务触发器选每天时间定在晚上你基本不写笔记的时段比如 23:30。操作选启动程序程序填cmd.exe参数填/c D:\Scripts\notes-backup.bat。这里有个细节直接在程序或脚本里填 bat 文件路径有时会闪退用 cmd 包一层最稳。关键设置藏在任务属性里常规页签勾选不管用户是否登录都要运行这样锁屏状态下也会执行同一页签勾选使用最高权限运行避免某些目录权限问题条件页签里把只有在计算机使用交流电源时才启动取消掉笔记本用电池时也要备份设置页签里勾选如果任务失败按以下频率重新启动间隔 5 分钟尝试 3 次应对偶发网络抖动。这几个选项看起来琐碎但每一个都对应过实际故障。尤其是电源条件那条我见过笔记本拔了电源之后备份静默停了一周的情况日志一条记录都没有很难发现。5.2 验证自动化是否真的生效配置完之后千万别以为就完事了。我的验证方法是改一个笔记文件手动运行一次任务右键任务点运行然后看三样东西——git log有没有新提交、远端仓库页面有没有新推送、日志文件有没有记录。三样都对上才算通了。之后连续观察两三天看每天是否按时产生提交。如果某天断了先查日志末尾的返回码。返回码非 0 就把对应那段命令单独拿出来在命令行里跑很快能定位。我自己的经验是九成的失败都是认证问题或网络问题剩下的一成是路径里有空格没加引号。5.3 补一份手动兜底清单自动化再稳也不该成为唯一路径。我给自己留了个备用操作流程写在笔记库根目录的 README 里打开命令行进入笔记目录执行git status看当前状态执行git add -A git commit -m manual: 手动备份执行git push。这四步在任何时候都能顶上去。另外我还会定期大概每季度做一次恢复演练——随便挑一个两周前的提交把它检出到一个临时目录确认内容完整可读。听起来多余但真出事时你才会庆幸自己练过。注意恢复演练千万别在笔记主目录里直接 checkout 旧提交那样会把当前文件改回旧版。正确做法是git worktree add到另一个目录或者干脆 clone 一份到别处验证。6. 常见故障与排查实录6.1 中文提交信息变问号症状是日志里提交信息全是????。原因是批处理文件的编码和当前代码页不匹配。解决方式是脚本开头加chcp 65001并且把 bat 文件本身保存为 UTF-8 编码不带 BOM。如果还不行检查一下 Git 的i18n.commitEncoding配置设为 utf-8。6.2 推送一直在认证环节失败按重要性排序排查先手动执行git push看是否正常正常则说明是任务运行环境的问题再确认任务是否勾选了不管用户是否登录都运行这个模式下凭据库往往取不到最后考虑换 SSH 方式。不要急着清空凭据管理器那会让你连手动推送都要重新输密码。6.3 仓库越来越大提交变慢文本笔记一般不会但如果混进了图片附件就有可能。用下面这条命令找出体积最大的历史对象git rev-list --objects --all | git cat-file --batch-check%(objecttype) %(objectname) %(objectsize) %(rest) | sort -k 3 -n -r | head -20如果发现某个大文件是不小心提交的用git filter-repo从历史里清除然后强推。注意这是破坏性操作执行前先完整备份本地仓库。更省事的办法是防患于未然把附件目录写进 .gitignore。6.4 计划任务显示上次运行结果 0x1返回码 1 通常意味着脚本里有命令失败了但由于重定向只记录输出不记录每一步的返回码直接看日志不容易定位。可以在脚本每个关键命令后面加一行echo step N rc%errorlevel%跑一次就知道断在哪。我自己的经验最常见的是 cd 目录不存在盘符变了或目录被重命名。6.5 编辑器正在写文件时被提交偶尔会出现某个文件内容不完整就被提交了。原因是计划任务恰好撞上了编辑器的保存瞬间。概率很低但确实发生过。缓解办法是把任务时间放在你明确不会写作的时段比如凌晨或者在脚本开头加个小延时等两秒再执行git add。真要严谨可以在提交前检查文件锁定状态不过对笔记场景有点过度设计了。故障现象首要排查点快速处理提交信息乱码代码页与文件编码加 chcp 65001文件存 UTF-8认证失败运行上下文与凭据可见性改 SSH 或改任务运行模式无新提交但有改动脚本是否执行到 add 之前看日志断点检查路径仓库膨胀是否误提交大文件查历史对象清理或用忽略推送成功但远端没变分支名是否一致确认 main/master 与远端对应7. 长期维护中的几条实战心得7.1 别把备份和同步混着做我一开始贪心想让笔记在多台机器上实时同步结果本地仓库和同步工具打架出现文件被改回旧版的情况。后来想明白了Git 负责存档同步工具负责分发两者各管一段最好不要让同步工具去同步 .git 目录。现在的做法是每台机器独立备份到自己的分支需要合并时手动处理麻烦一点但不会互相破坏。7.2 提交信息里别写敏感内容自动提交的信息里只有时间这是有意的。手动补提交时也不要在信息里写整理账号笔记这类描述因为你不知道远端仓库的可见性将来会怎么变。习惯从第一天养成比后来改历史容易得多。7.3 定期把远端仓库再备份一份远端不等于绝对安全。我的做法是每个月把远端仓库完整克隆一份到一块离线硬盘上放在抽屉里。听起来原始但这是唯一不依赖任何在线服务的兜底。克隆下来的是完整历史出任何问题都能从这份离线副本恢复。git clone --mirror 远端地址 D:\OfflineBackup\notes.git--mirror会连同所有分支和标签一起拿下来比普通 clone 更完整。7.4 恢复时的正确姿势真要回滚某天的内容不要脑子里想着整个仓库回到过去而应该先找出那一天对应的提交然后只把需要的文件取出来git log --oneline --until2024-05-20 23:59 git checkout commit -- 某个文件.md这样只影响指定文件其他内容保持现状风险最小。整个仓库硬回滚是最后手段用之前务必用git worktree或另 clone 一份做保险。我自己第一次做恢复时就是把整个分支 reset 了结果丢掉了当天更晚的一些改动虽然损失不大但那个教训记到现在。把这套流程跑顺之后备份这件事基本从我脑子里消失了它只是每天夜里默默发生一次。偶尔翻日志看到连续的记录那种踏实感比任何提醒都管用。
、中断、异常、接口、系统调用、体系结构)
