外观
GitHub Desktop：给 Markdown 修改留下版本记录
适合谁
如果你想知道笔记或项目「改了什么、为什么改、以前怎样写」，可以从 GitHub Desktop 学习 Git。它用图形界面展示文件差异和提交记录，不要求先记住终端命令。应用免费开源；GitHub 账户与托管服务的方案是另一个层面。官方介绍
先分清三种动作
| 动作 | 实际发生什么 |
|---|---|
| 在编辑器保存 | 修改写入当前磁盘文件 |
| Commit（提交） | 所选修改进入本地 Git 历史 |
| Publish / Push（发布／推送） | 仓库或新增提交发送到远端 |
只保存或提交不会自动把内容上传到 GitHub；已经上传过的敏感内容，也不能靠删除当前文件就从历史中消失。因此本练习只用虚构文本，不使用整个真实笔记库。
第一次使用：记录两次文字修改
- 从 GitHub Desktop 官网 安装对应 Mac 版本。
- 选择创建本地新仓库，命名为
notes-practice，选一个独立的练习父目录，并勾选初始化 README。确认最终路径没有指向已有项目。 - 用 VS Code 或其他纯文本编辑器打开生成的
README.md，写下一句学习目标并保存。 - 回到 Desktop，先确认左上角 Current repository（当前仓库）是
notes-practice，再在 Changes（更改）页逐项确认只有预期文件和那句文字发生变化。 - 输入简短说明，例如
docs: 记录学习目标，核对按钮上的目标分支后提交。 - 再添加一句练习结果、保存并提交。到 History（历史）中分别查看两次修改。
创建仓库时设置的提交姓名、邮箱可能随历史公开，不要误用不希望展示的私人资料。首次不会创建时，可跟随应用的官方教学仓库流程。创建本地仓库
如果要上传到 GitHub
上传是可选练习。先确认仓库里没有密钥、个人附件、构建目录和不应公开的草稿，再登录账号。确认当前仓库仍是 notes-practice 后选择 Publish repository，核对发布名称和所属账户，保留 Keep this code private。发布后到 GitHub 网页检查仓库可见性和文件；以后新增提交还需要 Push origin 才会到远端。发布项目说明
不要为上传已有项目随意删除或替换它的远端地址。学校或公司项目先遵循组织要求；私有仓库也不适合存放密钥。
常见问题与练习边界
Changes 为空时，先检查是否保存、是否打开了正确仓库、文件是否被忽略。远端缺少最新文字时，分开检查是否已经提交、是否已经推送。
Discard（丢弃）会修改工作区文件，不等于取消勾选；初学时想排除某个文件，先取消提交选择，不要直接丢弃。提交前可按文件和行查看差异。查看与提交更改
Git 不会自动备份未提交资料，也不擅长替代大附件备份。成功标准是能找到两次历史、解释本地和远端的差别，并保留 独立备份。