GitHub 基础知识介绍：从零开始 – wiki基地

作者： /

GitHub 基础知识介绍：从零开始

欢迎来到软件开发的世界！无论你是一名 aspiring 程序员、设计师、文档作者，甚至是项目经理，GitHub 都可能成为你工作中不可或缺的工具。它不仅仅是一个代码托管平台，更是一个强大的协作、版本控制和社区中心。

如果你之前从未接触过 GitHub 或 Git，这完全没关系。本文将带你从零开始，一步步理解 GitHub 的核心概念和基本操作。准备好了吗？让我们开始这段奇妙的旅程！

什么是 GitHub？

在深入探讨之前，我们先来弄清楚一个概念：Git 和 GitHub 是同一个东西吗？答案是：不是。

  • Git: Git 是一个分布式版本控制系统（Distributed Version Control System, DVCS）。你可以把它想象成一个超级智能的“存档管理器”，它可以追踪你项目文件的每一次修改，记录下是谁在什么时候做了什么改动，并且可以随时回溯到任何一个历史版本。Git 是一个本地软件，你可以在自己的电脑上安装和使用它，即使没有网络也能工作。
  • GitHub: GitHub 是一个基于 Git 的代码托管平台。它提供了一个线上的服务，让你能够存储你的 Git 仓库（repository），并在此基础上提供了丰富的协作功能，例如：
    • 方便地分享你的代码。
    • 多人协同开发同一个项目。
    • 追踪和管理项目任务（Issues）。
    • 代码审查（通过 Pull Request）。
    • 持续集成/持续部署（GitHub Actions）。
    • 建立开源社区。

所以，简单来说：Git 是底层的技术（版本控制），GitHub 是利用这项技术构建的一个线上服务平台。你可以使用 Git 而不使用 GitHub（例如在本地进行版本控制），但使用 GitHub 则离不开 Git 的概念。

为什么我们需要版本控制？

想象一下你正在写一份重要的文档（比如毕业论文或项目报告），你可能会保存多个版本，文件名可能是：
* 报告v1.doc
* 报告v2.doc
* 报告v2_修改版.doc
* 报告最终版.doc
* 报告最终版_导师意见修改.doc
* 报告最终版_真的不改了.doc

这很快就会变得混乱不堪。如果你和别人合作，情况会更糟：你们可能会互相覆盖对方的修改，或者难以合并各自的部分。

版本控制系统（如 Git）就是为了解决这些问题而诞生的。它可以：
1. 记录历史: 精确追踪每一次修改，你可以随时查看历史记录，了解项目的演变过程。
2. 回溯: 轻松回到项目的任何一个历史版本。
3. 分支: 在不影响主线开发的情况下，开辟新的“分支”进行实验性开发或功能开发。
4. 合并: 将不同分支的修改安全地合并在一起。
5. 协作: 允许多个人在同一个项目上高效协同工作，解决冲突。

GitHub 则将这些强大的功能带到了线上，让全球的开发者能够共同构建和改进软件。

GitHub 的核心概念

要开始使用 GitHub，理解一些核心术语至关重要。

  1. 仓库 (Repository / Repo):

    • 一个仓库就是一个项目。它包含了项目的所有文件、文件夹，以及 Git 记录的每次修改的历史记录。
    • 你可以拥有本地仓库（在你的电脑上）和远程仓库（如在 GitHub 上）。
    • 仓库是 GitHub 上组织项目的基本单位。

  2. 提交 (Commit):

    • 提交是你向 Git 历史记录中添加的一个“快照”。它记录了你在某个时间点对项目文件所做的修改。
    • 每次提交都应该包含一个简短、清晰的提交消息 (Commit Message)，说明你这次修改的目的或内容。好的提交消息是项目历史记录的重要组成部分。
    • 提交是 Git 的基本操作单元。

  3. 分支 (Branch):

    • 分支就像是项目主线（通常称为 main 或 master 分支）的一个分叉。你可以在分支上进行开发，而不影响主线或其他分支。
    • 这对于新功能开发、bug 修复或实验性尝试非常有用。当你在分支上的工作完成后，可以将其合并回主线。
    • 默认情况下，每个仓库都有一个主分支，通常是 main 或 master。

  4. 克隆 (Clone):

    • 克隆是指从 GitHub（或其他远程仓库）下载一个仓库到你的本地电脑。
    • 使用 git clone <仓库URL> 命令可以创建一个与远程仓库完全相同的本地副本，并自动建立与远程仓库的连接。

  5. 推送 (Push):

    • 推送是指将你在本地仓库中完成的提交上传到 GitHub 上的远程仓库。
    • 使用 git push 命令可以将你本地分支的最新提交同步到与之关联的远程分支上。

  6. 拉取 (Pull):

    • 拉取是指从 GitHub 上的远程仓库下载最新的修改到你的本地仓库。
    • 使用 git pull 命令通常相当于执行 git fetch（下载最新的历史记录）和 git merge（将下载的修改合并到当前分支）的组合。这可以确保你的本地仓库与远程仓库保持同步。

  7. Fork:

    • Fork 是 GitHub 上特有的一个操作，它是在 GitHub 上完整复制一个别人的仓库到你自己的账户下。
    • 你可以在这个 Fork 出来的仓库中随意修改，而不会影响到原始仓库。
    • Fork 通常用于当你想要给别人的项目贡献代码时：先 Fork 别人的仓库，然后在你的 Fork 上进行修改，最后通过 Pull Request 向原始仓库提交你的修改建议。

  8. 拉取请求 (Pull Request / PR):

    • Pull Request (PR) 是 GitHub 上实现协作的核心功能之一。当你完成了一个功能开发或 bug 修复（在你的分支上），并希望将其合并到项目的主线（或另一个分支）时，你可以创建一个 PR。
    • PR 会通知项目维护者你所做的修改，并提供一个界面供大家查看代码差异、发表评论、讨论修改建议。
    • 项目维护者可以审查你的代码，提出修改意见，最终选择接受并合并你的修改，或者关闭 PR。

  9. Issue:

    • Issue 是 GitHub 上用于追踪任务、bug、功能请求或任何与项目相关讨论的工具。
    • 任何人（通常是在仓库的贡献者）都可以创建一个 Issue 来报告问题或提出建议。
    • 开发者可以通过 Issue 来管理待办事项、讨论解决方案，并将 Issue 与特定的提交或 Pull Request 关联起来，形成一个完整的开发流程记录。

理解了这些概念，你就掌握了使用 GitHub 进行基本操作的语言。

从零开始使用 GitHub

好了，理论知识讲完了，现在让我们动手实践一下。

第一步：注册 GitHub 账户

访问 GitHub 官网：https://github.com/
点击右上角的 “Sign up” 按钮，按照提示填写必要信息（用户名、邮箱、密码），完成注册过程。你可能需要验证你的邮箱地址。选择合适的计划（对于个人使用者和大多数开源项目来说，免费计划就足够了）。

第二步：安装 Git

虽然 GitHub 是在线平台，但你需要在本地电脑上安装 Git 软件，才能进行版本控制操作并将本地仓库与 GitHub 上的远程仓库同步。

访问 Git 官网：https://git-scm.com/downloads
根据你的操作系统（Windows, macOS, Linux）下载并安装对应版本的 Git。安装过程中，对于新手来说，使用默认选项通常是安全的。

安装完成后，打开你的终端（macOS/Linux）或命令提示符/PowerShell/Git Bash（Windows），输入以下命令检查 Git 是否安装成功并查看版本：
bash
git --version
如果显示了 Git 的版本号，说明安装成功。

接下来，你需要配置你的 Git 用户名和邮箱。这些信息会记录在你每次提交中，方便追溯：
bash
git config --global user.name "你的名字"
git config --global user.email "你的邮箱@example.com"
请将 "你的名字" 和 "你的邮箱@example.com" 替换为你注册 GitHub 时使用的名字和邮箱。--global 选项表示这些设置将应用于你电脑上所有 Git 仓库。

第三步：在 GitHub 上创建一个新的仓库

登录你的 GitHub 账户：https://github.com/
点击页面右上角的 “+” 号，然后选择 “New repository”（新建仓库）。

填写仓库信息：
* Repository name (仓库名称): 给你的项目起一个名字。建议使用简洁、有意义的英文名（例如 my-first-project 或 hello-world）。
* Description (描述): 简要说明你的仓库是用来做什么的（可选，但推荐填写）。
* Public or Private (公开或私有):
* 公开 (Public): 所有人都可以看到这个仓库的代码。适合开源项目或你想展示的作品。
* 私有 (Private): 只有你和你邀请的协作者才能看到这个仓库的代码。适合个人项目或公司的内部项目。
* Initialize this repository with (初始化仓库):
* Add a README file: 推荐勾选。README 文件通常包含项目的介绍、安装和使用说明等，是项目的门面。GitHub 会自动为你创建一个 README.md 文件。
* Add .gitignore: 可选。.gitignore 文件可以告诉 Git 忽略哪些文件或文件夹（例如编译生成的文件、临时的日志文件、敏感的配置文件等），不将它们添加到版本控制中。
* Choose a license: 可选。为你的开源项目选择一个许可证，说明其他人可以使用、修改和分发你的代码的条款。

点击 “Create repository” 按钮，一个全新的 GitHub 仓库就创建好了！

第四步：将远程仓库克隆到本地

现在，你已经有了一个在线的 GitHub 仓库。接下来，我们要把它下载到你的本地电脑上。

在你的新仓库页面，找到绿色的 “Code” 按钮，点击它。你会看到一个弹窗，提供了仓库的 URL。通常使用 HTTPS 协议的 URL（例如 https://github.com/你的用户名/你的仓库名.git）。复制这个 URL。

打开你的终端（或 Git Bash），切换到你想要存放项目的文件夹（例如 cd ~/Documents/Projects）。然后运行 git clone 命令：
bash
git clone https://github.com/你的用户名/你的仓库名.git
将 <https://github.com/你的用户名/你的仓库名.git> 替换为你刚才复制的仓库 URL。

执行这个命令后，Git 会在当前目录下创建一个与仓库同名的文件夹，并将远程仓库的内容下载到其中。进入这个文件夹：
bash
cd 你的仓库名
现在，你已经在本地拥有了这个仓库的完整副本。

第五步：在本地进行修改并提交

现在你可以在本地仓库文件夹中创建或修改文件了。

例如，你可以创建一个新的文件 hello.txt：
在终端中使用命令创建：
“`bash
touch hello.txt # macOS/Linux

或者

echo “Hello, GitHub!” > hello.txt # Windows/macOS/Linux 都可以
“`
或者直接在文件浏览器中创建。然后用文本编辑器打开它，添加一些内容并保存。

当你修改或创建文件后，Git 知道你的工作目录有变化，但这些变化还没有被记录到 Git 的历史中。你可以使用 git status 命令查看当前仓库的状态：
bash
git status
它会告诉你哪些文件被修改了，哪些是新增的未追踪文件等等。新增的文件会显示为 “Untracked files”。

要将这些修改纳入下一次提交，你需要先将它们添加到暂存区 (Staging Area)。暂存区是一个准备区域，用于存放你想要包含在下一次提交中的修改。
使用 git add 命令将文件添加到暂存区：
bash
git add hello.txt # 添加单个文件
git add . # 添加当前目录下所有被修改或新增的文件
再次运行 git status，你会看到文件状态变成了 “Changes to be committed” (等待提交的修改)。

现在，暂存区的修改已经准备好了，可以进行提交了。使用 git commit 命令创建一个新的提交：
bash
git commit -m "添加了一个 hello.txt 文件并写入内容"
-m 选项后面跟着的是本次提交的提交消息 (message)。务必写一个简洁、有意义的消息，这对于回顾历史非常重要。

执行 git commit 后，你的修改就被永久地记录在了本地仓库的 Git 历史中，形成了一个新的提交。

第六步：将本地提交推送到远程仓库

你的提交目前只存在于你的本地仓库。为了让这些修改同步到 GitHub 上的远程仓库，你需要使用 git push 命令。

在本地仓库目录下的终端中运行：
bash
git push origin main
* origin: 这是 Git 默认给克隆下来的远程仓库起的别名。
* main: 这是你当前所在并希望推送的本地分支的名称（如果你使用的是旧版本的 Git 或不同的模板，这里可能是 master）。

如果你是第一次往这个远程仓库推送，可能需要输入你的 GitHub 用户名和密码（或者配置 SSH key / personal access token，后者更安全，但作为入门先了解用户名密码方式）。

推送成功后，刷新你的 GitHub 仓库页面，你会看到你刚刚添加或修改的文件以及你的提交消息已经显示出来了。

第七步：从远程仓库拉取最新修改

在实际开发中，特别是多人协作时，别人的提交也会同步到 GitHub 上的远程仓库。为了获取这些最新的修改，你需要使用 git pull 命令。

在你本地仓库的终端中运行：
bash
git pull origin main
这个命令会从名为 origin 的远程仓库的 main 分支下载最新的提交，并尝试将它们合并到你当前的本地分支。

如果在拉取过程中发生冲突（即你和别人修改了同一个文件的同一部分），Git 会提示你解决冲突。解决冲突需要你手动编辑文件，选择保留哪些修改，然后再次进行 git add 和 git commit 提交解决冲突后的版本。不过作为初学者，暂时遇到冲突的可能性较小，了解有这个过程即可。

GitHub 上的协作流程（简介）

前面我们介绍了 Fork 和 Pull Request 的概念。这是 GitHub 上常见的协作流程，特别是在参与开源项目时。

  1. Fork: 在 GitHub 上 Fork 你想贡献的项目到你自己的账户下。
  2. Clone: 将你 Fork 出来的仓库克隆到本地。
  3. Create Branch: 在本地为你打算实现的功能或修复的 bug 创建一个新的分支（例如 git checkout -b feature/add-login）。
  4. Develop & Commit: 在新的分支上进行开发、修改文件，并多次提交。
  5. Push: 将你的新分支推送到你 Fork 出来的远程仓库（例如 git push origin feature/add-login）。
  6. Create Pull Request (PR): 访问你 Fork 出来的仓库页面，GitHub 会提示你刚刚推送了一个新的分支，并询问是否创建 Pull Request。点击创建 PR，选择将你的分支合并到原始仓库的哪个分支（通常是 main 或 master）。
  7. Discuss & Review: 项目维护者和其他贡献者会在 PR 页面查看你的代码修改，发表评论，提出修改建议。
  8. Modify & Update PR: 根据反馈在本地继续修改，提交，然后推送到你的 Fork 仓库的同一个分支。这些新的提交会自动更新到已有的 PR 中。
  9. Merge: 当所有审查意见都解决，并且项目维护者认为你的修改可以接受时，他们会合并你的 PR，将你的修改正式添加到原始仓库的主线分支中。
  10. Sync Fork: 定期从原始仓库拉取最新的修改，同步到你 Fork 出来的仓库，保持你的 Fork 与原始仓库同步。

这个流程看起来可能有点复杂，但它是安全、规范地进行协作的有效方式。作为入门，先掌握克隆、修改、提交、推送、拉取这些基本操作更重要。

GitHub 的其他有用功能

除了核心的版本控制和协作功能，GitHub 还提供了许多其他有用的特性：

  • GitHub Pages: 可以为你的用户或组织、或者你的仓库构建静态网站，非常适合托管项目文档、博客或个人主页。
  • GitHub Actions: 强大的自动化工作流程工具，可以用于持续集成/持续部署 (CI/CD)，自动化构建、测试和部署你的代码。
  • Issues: 前面已经提到，用于任务跟踪、bug 报告和功能请求。
  • Projects: 看板工具，可以帮助你组织和规划 Issue 和 Pull Request，进行项目管理。
  • Wiki: 为你的仓库创建文档页面。
  • Code Search: 强大的代码搜索功能，可以在 GitHub 上的所有公开仓库中搜索代码。
  • Explore: 发现有趣的开源项目和社区。

总结与下一步

恭喜你！你已经学习了 GitHub 的基本概念，并了解了如何进行最基础的操作：注册、安装 Git、创建仓库、克隆、修改、提交和推送。这是迈向利用 GitHub 进行高效开发和协作的第一步。

记住关键流程：

  1. git clone: 从远程仓库获取到本地。
  2. Modify files: 在本地编辑文件。
  3. git status: 查看修改状态。
  4. git add: 将修改添加到暂存区。
  5. git commit: 将暂存区的修改提交到本地仓库历史。
  6. git push: 将本地提交推送到远程仓库。
  7. git pull: 从远程仓库获取最新修改到本地。

下一步建议：

  • 多加练习: 动手操作是最好的学习方式。尝试创建更多的仓库，在其中创建、修改、提交不同的文件，熟悉这个流程。
  • 学习 Git 的更多命令: Git 还有很多强大的命令，如 git log (查看提交历史)、git diff (查看文件差异)、git branch (管理分支)、git checkout (切换分支/回溯版本) 等等。官方的 Git 文档或在线教程是很好的学习资源。
  • 尝试使用分支: 在本地仓库创建一个新的分支，在分支上做一些修改，然后尝试合并回主分支。
  • 探索 GitHub 界面: 花时间浏览你的 GitHub 仓库页面，了解 Issues, Pull Requests, Actions 等选项卡的功能。
  • 参与开源项目: 找到一个你感兴趣的开源项目，尝试理解其结构，甚至可以尝试修复一个小 bug 或改进文档，然后发起你的第一个 Pull Request！

GitHub 是一个庞大而强大的平台，但它的核心是简单而有效的版本控制和协作理念。从零开始，循序渐进，你会发现它能极大地提升你的工作效率和协作体验。

祝你在 GitHub 的世界里探索愉快！

发表评论

您的邮箱地址不会被公开。 必填项已用 * 标注

滚动至顶部