幕雪

如何使用github从零开始：注册、仓库、提交、分支、协作与更多实用指南


本文旨在围绕“如何使用GitHub”这一核心，详细解答用户在入门和使用过程中可能遇到的各种实际操作问题。我们将聚焦于具体步骤和实用技巧，而非宽泛的理论或历史。无论您是想托管个人项目、学习版本控制，还是参与开源协作，都能在这里找到清晰的指引。

什么是GitHub？为什么使用它？费用如何？

什么是GitHub？

简单来说，GitHub是一个基于Git的在线代码托管平台。它提供了一个中心化的位置来存储您的代码项目（称为仓库 – Repository），并集成了强大的版本控制、协作和项目管理功能。它不仅仅是存放代码的地方，更是一个开发者社区和协作平台。

为什么要使用GitHub？

使用GitHub带来了诸多益处：

  • 版本控制 (Version Control): 通过Git，您可以轻松追踪代码的每一次改动，知道是谁、在何时、修改了什么。如果出现问题，可以随时回退到之前的版本。这是个人开发和团队协作的基石。
  • 协作开发 (Collaboration): GitHub提供了强大的工具，如分支(Branches)、合并请求(Pull Requests)和问题跟踪(Issues)，使得多人同时在一个项目上工作变得高效且有序。团队成员可以独立开发功能，然后通过规范的流程将代码合入主线。
  • 代码托管与备份: 将代码存储在云端，避免本地硬盘损坏导致代码丢失的风险。您可以随时随地访问和管理您的项目。

  • 展示与分享: GitHub是展示个人项目和贡献开源代码的绝佳平台，是许多技术招聘者了解开发者技能的重要途径。您的项目可以被他人发现、使用、甚至贡献。
  • 社区与发现: 您可以在GitHub上发现无数优秀的开源项目，学习他人的代码，参与贡献，与其他开发者交流。

使用GitHub需要花钱吗？

对于个人用户和大多数团队而言，GitHub提供了非常慷慨的免费层级。

  • 免费用户可以创建无限数量的公共仓库 (Public Repositories) 和私有仓库 (Private Repositories)。
  • 免费层级包含核心的版本控制、问题跟踪、拉取请求等协作功能。
  • 对于需要更高级功能（如更严格的访问控制、组织管理、更大的存储空间或更高级的自动化工作流）的个人、团队或企业，GitHub提供不同的付费计划 (GitHub Pro, GitHub Team, GitHub Enterprise)。

对于刚开始学习和使用GitHub的个人开发者来说，免费账号通常已经足够满足绝大部分需求。

开始使用：注册与基础操作

如何注册一个GitHub账号？

这是使用GitHub的第一步，非常简单：

  1. 访问GitHub的官方网站：https://github.com/
  2. 点击页面右上角的 “Sign up” (注册) 按钮。
  3. 按照提示输入您的信息：

    • 输入您的电子邮件地址。
    • 创建一个强密码。
    • 选择一个用户名。
    • 选择是否接收产品更新和通知的邮件。
  4. 完成人机验证（通常是一个小游戏或问答）。
  5. 点击 “Create account” (创建账号)。
  6. GitHub会向您提供的邮箱发送一封验证邮件，打开邮件并点击验证链接完成邮箱验证。
  7. 验证成功后，您可能需要填写一些关于您使用目的（如学生、教师、开发者等）的信息，这些信息是可选的，可以跳过。

现在，您就拥有了一个GitHub账号，可以开始探索了！

如何创建一个新的仓库 (Repository)？

仓库是您在GitHub上托管项目的基本单元，可以包含代码、文档、图片等任何与项目相关的文件。

  1. 登录您的GitHub账号。
  2. 在页面右上角，点击加号 (+) 图标，然后选择 “New repository” (新建仓库)。
  3. 进入创建仓库页面：

    • Owner (所有者): 默认是您的用户名，如果是组织账号则选择组织。
    • Repository name (仓库名称): 输入您的项目名称，建议使用简洁、有意义的名称，且通常使用小写字母、数字和连字符。
    • Description (描述 – 可选): 简要说明您的仓库是做什么的。
    • Public or Private (公共或私有): 选择仓库的可见性。公共仓库所有人可见，私有仓库只有您和您邀请的协作者可见。
    • Initialize this repository with (初始化仓库): 这是几个重要的选项：

      • Add a README file (添加 README 文件): 强烈建议勾选！README文件是项目的说明书，通常是Markdown格式，会自动显示在仓库主页，介绍项目是什么、如何使用等。
      • Add .gitignore: 如果您的项目是特定编程语言或框架，可以从模板中选择一个 .gitignore 文件。这个文件告诉Git哪些文件（如编译生成的文件、本地配置文件等）不应该被追踪和上传到仓库。
      • Choose a license (选择许可): 选择一个开源许可（如MIT, Apache, GPL等）表明您的项目如何被他人使用和分享。如果是不开源的私有项目，可以不选。
  4. 点击 “Create repository” (创建仓库) 按钮。

您的新仓库就创建好了，可以在线查看 README 文件和您选择的其他初始化文件。

如何将本地代码上传到GitHub (Push操作)？

创建好GitHub仓库后，您通常需要将本地电脑上已有的项目代码上传到这个仓库，或者将新编写的代码同步上去。这个过程主要通过Git命令行工具或GitHub Desktop客户端完成。这里以Git命令行演示：

情景一：本地已经有一个项目，想将其上传到新创建的GitHub仓库。

  1. 确保您的本地项目文件夹中已经初始化了Git仓库。如果在项目根目录还没有 `.git` 文件夹，打开命令行或终端，进入项目目录，运行：

    git init
  2. 将项目中的所有文件添加到Git的暂存区：

    git add .

    (如果您只想添加特定文件，请替换 ‘.’ 为文件路径)
  3. 提交暂存区的文件到本地仓库，创建第一个提交：

    git commit -m "Initial commit"

    (“Initial commit” 是本次提交的信息，简要说明改动内容)
  4. 将本地仓库关联到您在GitHub上创建的远程仓库。在您的GitHub仓库页面，点击绿色的 “Code” 按钮，复制仓库的HTTPS或SSH地址。然后在本地命令行运行：

    git remote add origin <您的GitHub仓库地址>

    (将 <您的GitHub仓库地址> 替换为您复制的地址，例如 `https://github.com/yourusername/yourrepository.git`)

    注：origin 是给远程仓库起的一个别名，习惯上用origin指代主远程仓库。
  5. 将本地仓库的代码推送到GitHub远程仓库：

    git push -u origin master

    或者如果是新的默认分支名 `main`：

    git push -u origin main

    注：`-u` 参数会在第一次推送时建立本地分支与远程分支的关联，之后只需要使用 git push 即可。master 或 main 是您要推送的本地分支名称，通常是主分支。
  6. 系统可能会提示您输入GitHub的用户名和密码（或者使用Token）。输入正确信息后，代码就会被上传到GitHub。

情景二：本地已经有与GitHub仓库关联的项目，想将新的改动上传。

  1. 在本地修改或添加文件。
  2. 将改动添加到暂存区：

    git add . (或指定文件)
  3. 提交改动到本地仓库：

    git commit -m "您的提交信息，描述本次改动"
  4. 将本地的提交推送到GitHub远程仓库：

    git push

如何从GitHub获取代码 (Clone/Fork操作)？

从GitHub获取代码有两种主要场景：

  • Clone (克隆): 获取您自己或您有写入权限的仓库的完整副本到本地，用于继续开发。

    在GitHub仓库页面，点击绿色的 “Code” 按钮，复制仓库的HTTPS或SSH地址。打开命令行或终端，进入您希望存放项目的目录，运行：

    git clone <您的GitHub仓库地址>

    Git会自动将整个仓库（包括所有历史版本和分支）下载到本地一个与仓库同名的文件夹中。您就可以在本地进行修改和开发，并通过 `git pull` 命令拉取远程仓库的最新改动，通过 `git push` 命令推送您的改动。
  • Fork (派生/分叉): 获取没有写入权限的公共仓库的副本到您的GitHub账号下。这通常用于您想在别人的开源项目基础上进行修改或贡献代码，但又不能直接修改原仓库。

    在您感兴趣的公共仓库页面，点击右上角的 “Fork” 按钮。GitHub会在您的账号下创建一个该仓库的完整副本。这个副本是独立于原仓库的。您然后可以像克隆您自己的仓库一样，将这个Fork出来的仓库克隆到本地进行修改，并将修改推送回您GitHub账号下的那个副本仓库。

    如果您想将您的修改贡献回原仓库，就需要通过后续的拉取请求 (Pull Request) 流程。

理解核心概念：版本控制与分支

版本控制：提交 (Commits) 是什么？

在Git中，提交 (Commit) 是对仓库在某个特定时间点状态的一次快照。每次您完成一组相关的修改，并希望将其记录下来时，就创建一个提交。

  • 每个提交都有一个唯一的标识符（哈希值）。
  • 每个提交都包含对文件的改动（添加、删除、修改）。
  • 每个提交都有一个提交信息 (commit message)，描述了本次改动的内容和目的。良好的提交信息对于追踪历史和协作非常重要。
  • 提交是本地Git仓库中的操作，只有执行 `git push` 后，本地的提交才会被同步到远程的GitHub仓库。

通过一系列的提交，Git构建了一个项目的历史记录，您可以查看任何一个提交时的项目状态，甚至回退到某个提交。

分支 (Branches) 如何工作？

分支 (Branch) 是指向某次提交的可变指针。默认情况下，Git仓库有一个主分支，通常是 `master` 或 `main`。分支的强大之处在于，它允许您在不影响主线开发的情况下，创建独立的开发线。

想象一下，主分支是一条稳定的河流。您想要建造一座桥（开发一个新功能）。您可以在河流旁边开挖一条平行的运河（创建分支），在运河上建造桥梁（在新分支上进行代码修改和提交）。在运河上的工作不会影响到主流。当桥梁建好并经过测试（功能开发完成并稳定），您可以将运河并入主流（合并分支），让所有人都能使用这座桥。

使用分支的好处：

  • 隔离性: 不同的功能开发、Bug修复可以在各自的分支上进行，互不影响。
  • 并行开发: 多个开发者可以同时在不同的分支上工作。
  • 稳定性: 主分支 (如 `main`) 通常用于存放稳定、可发布的代码，新功能在开发分支上完成后再合入。

如何创建、切换和合并分支？

这些操作通常在本地使用Git命令行完成：

  1. 查看所有分支:

    git branch

    (当前所在分支会有一个星号 *)
  2. 创建新分支:

    git branch <新分支名称>

    (这只创建了分支，但您仍然在当前分支上)
  3. 切换到分支:

    git checkout <目标分支名称>

    或（新版本Git推荐）

    git switch <目标分支名称>
  4. 创建并立即切换到新分支:

    git checkout -b <新分支名称>

    或（新版本Git推荐）

    git switch -c <新分支名称>
  5. 将一个分支的改动合并到当前所在的分支:

    首先切换到您想合并进来的目标分支（例如切换回 `main`）：

    git checkout main

    然后执行合并命令，将开发完成的分支（例如 `feature/new-feature`）合并进来：

    git merge <要合并进来的分支名称>

    (如果出现代码冲突，需要手动解决)
  6. 删除分支:

    合并后通常可以删除不再需要的开发分支：

    git branch -d <要删除的分支名称>

    (-D 选项用于强制删除，即使分支没有完全合并)
  7. 将本地新创建的分支推送到GitHub:

    git push -u origin <您的本地分支名称>

    (-u 同样用于建立关联)

GitHub上的协作

GitHub的强大之处在于其为协作提供了流畅的工作流程和工具。核心的协作机制围绕着分支、提交、拉取请求 (Pull Requests) 和问题跟踪 (Issues)。

如何发起或参与协作？

参与一个公共仓库的协作通常遵循以下流程：

  1. Fork (派生) 原仓库: 如前所述，在原仓库页面点击 “Fork” 按钮，在自己的GitHub账号下创建副本。
  2. Clone (克隆) 您Fork出的仓库: 将您账号下的副本克隆到本地电脑。

    git clone <您Fork出的仓库地址>
  3. 创建新分支: 在本地仓库中，为您的贡献（新功能或Bug修复）创建一个专门的分支。给分支起一个有意义的名字，例如 `feature/add-dark-mode` 或 `fix/login-bug`。

    git checkout -b <您的分支名称>
  4. 进行代码修改和提交: 在新分支上编写代码，并频繁地进行提交 (Commit)，提交信息要清晰。

    git add .

    git commit -m "实现了暗黑模式的基础功能"
  5. 推送到您的GitHub仓库: 将本地的改动推送到您在GitHub上Fork出的仓库的对应分支。

    git push origin <您的分支名称>
  6. 创建拉取请求 (Pull Request): 这是最关键的一步。前往您在GitHub上的Fork仓库页面，GitHub通常会提示您最近有推送新分支，并提供比较和创建拉取请求的按钮。点击创建拉取请求 (New pull request)。

对于有写入权限的私有仓库协作，流程更简单：直接克隆原仓库到本地，创建分支，修改，提交，推送到原仓库的对应分支即可，通常不需要Fork。推送到原仓库后，也可以创建Pull Request来请求将您的分支合并到主分支。

如何提交改进或修复 (Pull Requests)?

拉取请求 (Pull Request – PR)，在某些平台也称合并请求 (Merge Request – MR)，是通知项目维护者您已经完成了一些改动，并希望将这些改动合并到原仓库的一种方式。这是一个重要的协作和代码审查环节。

继续上面的流程，创建Pull Request：

  1. 在您Fork出的仓库页面或直接在GitHub的PR页面，选择比较的基础分支 (base branch) 和您的改动分支 (compare branch)。基础分支通常是原仓库的主分支（如 `main`），比较分支是您推送了改动的那个分支。
  2. GitHub会显示您这两个分支之间的所有提交和文件改动对比 (diff)。
  3. 填写拉取请求的标题和详细描述。标题要简明扼要，描述中说明本次PR的目的（解决了什么问题、实现了什么功能）、改动了哪些内容、如何测试等等。您可以引用相关的 Issues (问题)。
  4. 点击 “Create pull request” (创建拉取请求)。
  5. 拉取请求创建后，原仓库的维护者和其他协作者会收到通知。他们可以在PR页面查看您的代码改动，在特定的代码行上留言评论，提出问题或建议修改。您可以在本地根据反馈修改代码，提交到您Fork出的仓库的同一个分支，PR会自动更新显示这些新的提交。
  6. 经过讨论和代码审查，如果维护者认为您的改动没问题，他们会将您的分支合并到原仓库的基础分支中。
  7. 合并完成后，您的贡献就正式成为原项目的一部分了！您可以删除您Fork出的仓库中的那个功能分支，并在本地同步原仓库的最新改动 (`git pull upstream main`，如果原仓库添加为 `upstream` 远程)。

如何报告问题或提建议 (Issues)?

问题跟踪 (Issues) 是GitHub提供的另一个核心协作工具，用于讨论项目的Bug、功能请求、任务分配等。

在任何GitHub仓库页面，通常会有一个 “Issues” 选项卡。点击进去：

  1. 您可以查看当前仓库的所有 Issue，包括已开启 (Open) 和已关闭 (Closed) 的。在提交新的 Issue 之前，最好先查看现有 Issue，避免重复提交。
  2. 点击 “New issue” (新建 Issue) 按钮。
  3. 选择 Issue 的类型，有些仓库会定义不同的模板（如Bug报告、功能请求）。
  4. 填写 Issue 的标题和详细描述。标题要清晰，描述中尽可能详细地说明问题（如何重现、期望的结果、实际结果等）或建议（为什么需要这个功能、它的用途是什么等）。
  5. 您可以@提及其他GitHub用户来引起他们的注意。
  6. 您还可以为 Issue 打标签 (Labels)、分配负责人 (Assignees)、关联到项目看板 (Projects) 或里程碑 (Milestones)，这有助于项目管理。
  7. 点击 “Submit new issue” (提交新 Issue)。

Issue 提交后，项目成员可以在下方留言讨论。如果问题被解决或建议被采纳实现，Issue 通常会被关闭。

如何处理代码冲突 (Conflicts)?

代码冲突发生在 Git 无法自动合并不同分支上的相同文件的改动时。例如，两个人在各自的分支上修改了同一个文件的同一行代码，在合并时就会发生冲突。

当您执行 `git merge` 或 `git pull`（`pull` 实际上是 `fetch` + `merge`）时，如果发生冲突，Git 会提示您。受冲突的文件中会包含特殊标记，指示出冲突的部分，例如： 

<<<<<<< HEAD
This is the content in the current branch (HEAD).
=======
This is the content from the branch being merged.
>>>>>>> feature/my-branch

处理冲突的步骤：

  1. 打开包含冲突标记的文件。
  2. 手动编辑文件，删除 Git 插入的冲突标记 (`<<<<<<<`, `=======`, `>>>>>>>` 和 `HEAD`)，并决定保留哪些代码（可以是当前分支的代码、待合并分支的代码，或者结合两者的改动）。
  3. 解决所有冲突标记后，保存文件。
  4. 将修改后的文件添加到暂存区：

    git add <冲突文件的路径>
  5. 提交合并结果。Git 会自动生成一个默认的合并提交信息，您可以接受或修改它：

    git commit
  6. 如果是在进行 `git pull` 时发生冲突并解决，提交合并结果后，后续的 `git push` 可能会需要指定分支或使用 `–force`（需谨慎）。如果在合并分支时解决冲突，提交合并结果就完成了本地合并。然后您可以将合并后的分支推送到远程仓库。

处理冲突需要小心谨慎，确保最终的代码是正确且符合预期的。一些代码编辑器和GitHub Desktop等客户端提供了图形界面来帮助解决冲突。

其他实用功能与技巧

使用GitHub Pages创建个人或项目网站

GitHub Pages 是一项非常实用的功能，可以直接将托管在GitHub仓库中的静态网站文件发布到互联网上。这对于托管个人简历、项目文档、博客或简单的静态网站非常方便且免费。

如何设置 GitHub Pages：

  1. 确保您的仓库中包含网站文件（HTML, CSS, JavaScript, 图片等）。网站的首页通常是 `index.html`。
  2. 进入您的仓库页面，点击 “Settings” (设置) 选项卡。
  3. 在左侧菜单中找到并点击 “Pages”。
  4. 在 “Source” (来源) 部分，选择您想要用来构建网站的分支（通常是 `main` 或 `master`）。您还可以选择网站文件是放在根目录还是 `/docs` 文件夹下。
  5. 保存设置。GitHub 会自动开始构建并部署您的网站。
  6. 部署完成后，GitHub会在页面顶部显示您的网站地址，格式通常是 `yourusername.github.io/yourrepositoryname` (对于项目网站) 或 `yourusername.github.io` (对于用户或组织网站，仓库名必须是 `yourusername.github.io`)。首次部署可能需要几分钟。

您还可以使用 Jekyll 等静态网站生成器来构建更复杂的博客或文档网站，并将其托管在 GitHub Pages 上。

使用GitHub Desktop客户端

如果您不习惯使用命令行进行Git操作，GitHub提供了官方的桌面客户端 (GitHub Desktop)，它提供了友好的图形界面来执行常见的Git和GitHub操作，如克隆、提交、拉取、推送、创建分支、合并、管理拉取请求等。

使用 GitHub Desktop：

  1. 访问 https://desktop.github.com/ 下载并安装对应您操作系统的版本。
  2. 打开 GitHub Desktop，登录您的GitHub账号。
  3. 您可以选择克隆一个现有的仓库（会显示您账号下的仓库列表），或者创建一个新的本地仓库并发布到GitHub。

  4. 在客户端中，您可以直观地看到文件的改动，选择要包含在提交中的文件，编写提交信息，然后点击提交按钮。
  5. 通过界面上的 “Push origin” (推送到远程) 或 “Fetch origin” (从远程获取) 按钮来与GitHub仓库同步。
  6. 客户端也支持分支的创建、切换、合并以及管理拉取请求。

GitHub Desktop 是Git命令行的一个良好替代品，尤其适合新手或偏好图形界面的用户。

如何保护你的账号安全？

保护您的GitHub账号安全非常重要，因为它可能托管着您的重要代码或涉及团队的敏感项目。

  • 使用强密码: 创建一个复杂且唯一的密码，避免使用与其他网站相同的密码。
  • 启用双重认证 (Two-Factor Authentication – 2FA): 强烈建议启用2FA。启用后，登录GitHub账号不仅需要密码，还需要您手机上的验证码或物理安全密钥。即使密码泄露，没有第二重验证也很难登录。可以在账号的 Settings -> Security -> Two-factor authentication 中设置。
  • 定期审查授权应用: 在 Settings -> Applications -> Authorized OAuth Apps 中查看您授权给第三方应用的访问权限，删除不再使用或来源不明的应用授权。
  • 使用SSH Keys: 使用SSH协议进行Git操作比HTTPS更安全，因为它不需要每次输入密码，而是通过密钥对进行身份验证。可以在 Settings -> SSH and GPG keys 中添加您的SSH公钥。
  • 警惕钓鱼攻击: 小心通过邮件或不明链接索要GitHub账号信息的情况。

总结

GitHub是一个功能强大且用途广泛的平台，掌握其基本使用方法对于任何从事软件开发或需要进行文档版本管理和协作的人来说都至关重要。从注册账号、创建仓库、提交代码，到理解分支和协作流程（Pull Requests, Issues），再到利用GitHub Pages等实用功能，每一步都旨在帮助您更高效地管理项目和与他人合作。

开始使用GitHub最重要是实践。尝试创建一个自己的小项目仓库，或者Fork一个感兴趣的开源项目，按照本文介绍的步骤进行操作。随着您使用频率的增加，会对Git和GitHub的工作流越来越熟悉。


如何使用github