这篇教程适合刚接触 Git 的新手，用最省心的方式把“版本控制”用起来：用 GitHub Desktop 代替命令行完成 80% 的日常操作。
你需要：一台 Windows 或 macOS 电脑；一个 GitHub 账号（可选，但推荐）；稳定网络。
名词先搞清：仓库（Repository）= 项目；提交（Commit）= 一次保存记录；分支（Branch）= 并行修改线；同步（Push/Pull）= 把本地和远端对齐。
1）打开 GitHub Desktop 官网下载并安装（Windows 直接安装包，macOS 拖拽到“应用程序”）。
2）首次打开时建议先登录 GitHub（也可以稍后再登录）。登录的好处：克隆私有仓库、拉取组织仓库更顺畅。
注意：如果你只想管理本地文件夹，也可以不登录，但后续推送到远端会受限。
常见两种方式：
方式A：你在网页上看到一个项目，复制它的 URL，然后在 GitHub Desktop 里选择“Clone a repository”，粘贴 URL → 选择本地路径 → Clone。
方式B：如果你已登录账号，GitHub Desktop 会列出你有权限的仓库，直接选中即可。
建议路径：不要放在中文/超长路径里（例如桌面深层文件夹），尽量放到 D:Projects 或 ~/Projects 这类短路径，能减少奇怪报错。
- Changes：你改了哪些文件、哪些行，准备提交。
- History：每次提交的时间线，可回看、对比。
- Repository：仓库设置、分支、远端等入口。
小技巧：每次准备提交前，先在 Changes 里逐个勾选文件，避免把临时文件/配置误提交。
很多人第一次用 Git 的坑是“直接在 main/master 上改”。更稳的做法：
1）在顶部分支菜单选择“New branch”。
2）给分支取名：例如 feature/login-ui、fix/readme，不要用“新建分支1”。
3）确认基于 main/master 创建。
为什么要分支？因为你可以随时丢弃某个分支的尝试，不影响主线；也方便把改动做成 Pull Request 让别人审核。
1）在 Changes 里确认要提交的文件已勾选。
2）填写提交信息（Summary）：用“做了什么”开头，例如“更新安装步骤”“修复按钮对齐”。不要只写“update”。
3）点击“Commit to <branch>”。
提交频率建议：每完成一个小目标就提交一次（例如改完一个模块/修完一个 bug），比攒一大坨改动更容易排错与回退。
- Push：把本地提交推到 GitHub（远端）。
- Pull：把远端最新提交拉到本地。
常用流程：
1）开始干活前先 Pull（确保你在最新基础上修改）。
2）提交后再 Push（把成果同步上去）。
提示：第一次 Push 新分支时，GitHub Desktop 通常会提示“Publish branch”，点一下即可。
如果是个人项目，你可以在 GitHub Desktop 里把分支合并回 main：
1）切到 main → Pull 更新。
2）切回功能分支 → 选择“Branch”菜单里的合并/对比选项。
如果是团队协作，更推荐：
1）把分支 Push 到远端。
2）在 GitHub 上创建 Pull Request（PR），让自己或同事 review 后再合并。
1）提示 Permission denied / 403 / 没有权限推送
- 检查你是否登录了正确的 GitHub 账号。
- 如果是组织/私有仓库，确认你有写入权限（Write/Developer）。
- 仓库可能要求用 Token/SSH：优先在 GitHub Desktop 的登录/授权流程里完成，不要随便复制来路不明的脚本或“破解教程”。
2）提示 Merge conflict（冲突）
- 冲突不是坏事，表示同一段代码被不同人改了。
- 做法：先 Pull 拉取最新 → GitHub Desktop 通常会指引你打开冲突文件 → 选择保留哪一段或手动整合 → 再次 Commit。
- 建议：冲突解决后立刻运行项目/预览，确认没有把功能改坏。
3）文件名乱码/路径过长/无法创建文件
- 尽量把仓库放在短路径（例如 D:Projects）。
- 避免在文件名里混用特殊符号；团队统一命名规则。
- Windows 用户如果遇到路径长度问题，尽量减少目录层级，或在系统策略允许的情况下开启长路径支持（公司设备请先遵守 IT 规范）。
4）Changes 里出现一堆不该提交的文件（缓存、日志、构建产物）
- 优先用 .gitignore 忽略，例如 node_modules、dist、.DS_Store 等。
- 先不要盲目全选提交，容易把体积巨大或隐私配置推上去。
1）提交信息写清楚：以后回看历史能救命。
2）一件事一个分支：功能/修复/文档分开做，减少混乱。
3）每次开工先 Pull：减少冲突。
4）重要改动先 Commit 再实验：想回退时非常快。
5）别把账号密码、密钥、个人隐私文件提交进仓库：一旦推送到远端，很难彻底消除痕迹。
1）新建一个空文件夹作为项目。
2）用 GitHub Desktop 创建仓库（Create a new repository）。
3）创建一个 README.md 写两行说明 → Commit。
4）新建分支 feature/intro → 修改 README → Commit → Push。
5）在 GitHub 创建 PR → 合并 → 回到 main Pull 更新。
完成这套流程后，你就真正“会用 Git 了”。
