首页

版本控制入门指南

你正在做一个项目，结果改动了一些东西把一切都搞坏了。你不记得改了什么，真希望能回到代码还能用的时候。版本控制就像电子游戏中的存档点——每次”提交”工作时，就创建了一个可以随时返回的还原点。GitHub 将你的存档点保存在云端，这样代码就被安全备份，可从任何电脑访问。

核心概念

• Git - 版本控制软件，在你的电脑上跟踪文件的变更
• GitHub - 在云端存储代码的网站，就像代码的 Google Drive
• GitHub Desktop - 让 Git 变得简单易用的应用，用按钮操作而不是命令
• Repository（仓库/repo） - 跟踪所有变更的项目文件夹

你需要准备的

• 一台 Windows 或 Mac 电脑（GitHub Desktop 不支持 Linux）
• 互联网连接
• 用于创建 GitHub 账户的电子邮箱
• 15-20 分钟

步骤 1：创建 GitHub 账户

• 打开网页浏览器
• 访问 github.com
• 点击 Sign up
• 输入你的邮箱，创建密码，选择用户名
• 完成验证步骤

步骤 2：下载 GitHub Desktop

• 访问 desktop.github.com
• 点击 Download 按钮
• 打开下载的文件进行安装

在 Windows 上：

• 双击安装程序文件
• GitHub Desktop 会自动安装并打开

在 Mac 上：

• 打开下载的 .zip 文件
• 将 GitHub Desktop 拖到你的应用程序文件夹
• 从应用程序打开 GitHub Desktop

步骤 3：登录 GitHub Desktop

• 打开 GitHub Desktop
• 点击 Sign in to GitHub.com
• 你的浏览器会打开——如有要求请先登录，然后点击 Authorize desktop
• 如果浏览器询问是否打开 GitHub Desktop，点击 打开（Open）或 允许（Allow）
• 返回 GitHub Desktop
• 点击 Finish 完成设置

步骤 4：创建你的第一个仓库

• 在 GitHub Desktop 中，点击 Create a New Repository on your Local Drive
• 填写表单：
  • Name： my-first-project（或任何你喜欢的名字）
  • Description： Learning version control（可选）
  • Local Path： 选择保存位置（Documents 文件夹就可以）
  • 勾选 Initialize this repository with a README
• 点击 Create Repository

步骤 5：打开你的项目文件夹

• 在 GitHub Desktop 中，点击菜单栏中的 Repository
• 选择 Show in Finder（Mac）或 Show in Explorer（Windows）
• 你会看到一个以你的项目命名的文件夹
• 里面有一个名为 README.md 的文件

步骤 6：做出第一次修改

• 在任何文本编辑器中打开 README.md（记事本、文本编辑或 VS Code）
• 将内容替换为：

  # My First Project
  
  I'm learning version control with GitHub Desktop.
  
  ## What I'm Building
  
  This is a practice project to learn how to:
  - Track changes to my code
  - Create save points (commits)
  - Back up my work to GitHub
  

• 点击 文件 → 保存（VS Code 中为 File → Save）

步骤 7：创建你的第一个提交（存档点）

• 返回 GitHub Desktop
• 你会在右侧看到高亮显示的变更（绿色 = 添加的内容，红色 = 删除的内容）
• 在左下角，输入提交消息：Updated README with project description
• 点击蓝色的 Commit 1 file to main 按钮（数字与你修改的文件数量一致）

步骤 8：推送到 GitHub（备份到云端）

• 点击顶部蓝色的 Publish repository 按钮
• 保持名称不变
• 如果想让其他人看到，取消勾选”Keep this code private”（可选）
• 点击 Publish Repository

你的代码现在已在线备份到：https://github.com/YOUR-USERNAME/my-first-project

接下来的步骤

• 再次编辑你的 README 文件并提交变更
• 在项目文件夹中创建一个新文件并提交
• 探索 History 标签，查看项目如何随时间演变

故障排除

• 无法登录 GitHub - 检查互联网连接。先尝试在 github.com 登录以验证凭据是否有效。
• 变更没有出现在 GitHub Desktop 中 - 确保已保存文件。先点击其他应用，再切换回 GitHub Desktop，或者重启 GitHub Desktop。
• 推送失败并显示”rejected”错误 - 有其他人推送了变更。点击 Fetch origin，然后点击 Pull origin，再点击 Push origin。

工作流程概览

• 对项目文件进行修改
• 在 GitHub Desktop 中查看变更（绿色 = 添加的内容，红色 = 删除的内容）
• 写一条描述性的提交消息，然后点击底部的蓝色提交按钮（显示类似 Commit 1 file to main 的文字）
• 点击 Push origin 备份到 GitHub
• 重复以上步骤

由 Steven Ge 创建于 2025 年 12 月 7 日。