GitHub基础教程：从零开始 – wiki基地

作者： /

GitHub基础教程：从零开始，掌握现代开发协作的核心

在当今软件开发和许多协作性项目中，版本控制系统（Version Control System, VCS）已成为不可或缺的工具。而在众多VCS中，Git凭借其强大的功能和灵活性脱颖而出，成为事实上的行业标准。GitHub则是在Git的基础上构建的全球最大的代码托管和协作平台。对于任何希望进入编程、数据科学、开源贡献或任何涉及文本文件协作领域的人来说，掌握Git和GitHub的基本操作都是一项至关重要的技能。

本教程旨在为完全没有Git或GitHub使用经验的初学者提供一份详尽的指南，从最基本的概念讲起，一步步引导你完成安装、配置、创建仓库、进行版本控制以及参与协作的全过程。我们的目标是让你在阅读完本文后，能够自信地开始使用GitHub进行个人项目管理和参与简单的团队协作。

第一部分：理解核心概念——什么是Git？什么是GitHub？

在深入实践之前，我们必须先厘清两个关键概念：Git 和 GitHub。

  1. Git：分布式版本控制系统

    • 版本控制是什么？ 想象一下你正在写一篇重要的文档或代码。你可能会保存多个版本（比如 report_v1.docx, report_v2_final.docx, report_final_really_final.docx）。版本控制系统就是一种更智能、更系统化的方式来管理这些变化。它能记录下每一次文件的修改历史，让你能够随时回溯到之前的任何一个状态，比较不同版本间的差异，甚至合并不同人的修改。
    • Git的特点： Git是由Linux之父Linus Torvalds为了更好地管理Linux内核开发而创建的。它是一个分布式版本控制系统。这意味着每个开发者的本地计算机上都拥有一个完整的代码仓库（Repository）及其完整的历史记录。这与传统的集中式VCS（如SVN）不同，后者通常只有一个中央服务器存储所有版本历史。
    • Git的核心优势：
      • 速度快： 大部分操作（如提交、查看历史、创建分支）都在本地进行，无需网络连接，速度极快。
      • 强大的分支管理： Git的分支功能极其轻量且强大，使得并行开发、试验新功能、修复Bug变得非常容易且安全。
      • 分布式： 即使中央服务器宕机，每个开发者本地仍有完整副本，提高了数据安全性和开发效率。
      • 数据完整性： Git通过SHA-1哈希算法确保内容的完整性，每一次提交都有唯一的标识符。

  2. GitHub：基于Git的代码托管与协作平台

    • GitHub不是Git： 这是一个常见的误解。Git是一个命令行工具，一个软件。GitHub则是一个网站和服务，它使用Git作为其核心技术。你可以把Git想象成电子邮件协议（SMTP/POP3），而GitHub则像是Gmail或Outlook这样的邮件服务提供商。
    • GitHub提供的服务：
      • 代码托管： 提供一个云端的服务器来存储你的Git仓库（Repositories）。
      • 协作工具： 提供了强大的协作功能，如Pull Requests（拉取请求，用于代码审查和合并）、Issues（问题跟踪）、Projects（项目管理看板）、Wikis（文档协作）等。
      • 社交平台： 开发者可以在GitHub上关注他人、发现有趣的项目、参与开源社区。
      • 个人作品集： GitHub个人主页已成为许多开发者展示技能和项目经验的重要平台。
      • 自动化： GitHub Actions提供了强大的CI/CD（持续集成/持续部署）和自动化工作流能力。

总结： Git是底层的版本控制工具，而GitHub是利用Git提供代码托管和协作平台。我们将在本地使用Git命令来管理文件版本，然后使用GitHub作为远程仓库来备份、分享和协作。

第二部分：准备工作——安装Git与注册GitHub账户

  1. 安装Git

    • Windows: 访问 Git 官方网站 (https://git-scm.com/downloads)，下载适用于Windows的安装程序。按照安装向导的提示进行安装，大部分选项保持默认即可。安装完成后，你会获得Git Bash（一个模拟Linux命令行的工具）、Git CMD以及图形界面工具。推荐主要使用Git Bash。
    • macOS:
      • 最简单的方式是安装Xcode Command Line Tools。打开“终端”（Terminal）应用程序，输入 git --version。如果未安装，系统会提示你安装命令行开发者工具，按提示操作即可。
      • 或者，也可以通过Homebrew（一个包管理器）安装：在终端输入 brew install git。
      • 同样可以从官网下载安装程序。
    • Linux (Debian/Ubuntu): 在终端输入 sudo apt update && sudo apt install git。
    • Linux (Fedora): 在终端输入 sudo dnf install git。
    • 验证安装： 安装完成后，在你的终端（或Git Bash）中输入 git --version，如果能看到Git的版本号，说明安装成功。

  2. 注册GitHub账户

    • 访问 GitHub 官网 (https://github.com/)。
    • 点击右上角的 “Sign up”。
    • 按照提示输入你的邮箱、创建密码、设置用户名。用户名将是你在GitHub上的唯一标识，也是你个人主页URL的一部分（https://github.com/your-username），请谨慎选择。
    • 完成邮箱验证等步骤。
    • 注册完成后，花点时间熟悉一下GitHub的界面，特别是你的个人主页（Profile）和仪表盘（Dashboard）。

  3. 配置Git

    • 在你第一次使用Git提交代码前，需要设置你的用户名和邮箱地址。这些信息会嵌入到你的每一次提交记录中，表明是谁进行了修改。
    • 打开你的终端（或Git Bash），输入以下命令，将引号中的内容替换为你自己的信息：
      bash
      git config --global user.name "Your Name"
      git config --global user.email "[email protected]"
    • --global 参数表示这个配置应用于你这台电脑上的所有Git仓库。如果你想为某个特定项目设置不同的用户名/邮箱，可以在该项目目录下运行不带 --global 的相同命令。
    • 你可以使用以下命令检查配置是否成功：
      bash
      git config --global user.name
      git config --global user.email

第三部分：本地仓库实战——创建你的第一个Git项目

现在我们将在你的本地计算机上创建一个项目，并使用Git进行版本控制。

  1. 创建项目目录

    • 在你喜欢的位置（比如“文档”或专门的“项目”文件夹）创建一个新的文件夹，作为你的项目根目录。例如，我们创建一个名为 my-first-project 的文件夹。
    • 使用命令行进入这个目录：
      bash
      # 如果在根目录，可能需要先 cd Documents 或 cd Projects 等
      mkdir my-first-project
      cd my-first-project

  2. 初始化Git仓库 (git init)

    • 在项目目录 (my-first-project) 中，运行以下命令：
      bash
      git init
    • 这条命令会在当前目录下创建一个名为 .git 的隐藏子目录。这个 .git 目录包含了Git仓库的所有元数据和对象数据库，是Git工作的核心。千万不要手动修改或删除这个目录里的任何东西！
    • 现在，my-first-project 文件夹就成了一个Git仓库（Repository），Git已经开始“监视”这个目录了。

  3. 工作区、暂存区和版本库

    • 理解这三个概念对于掌握Git至关重要：
      • 工作区 (Working Directory): 就是你在电脑上看到的项目文件夹 (my-first-project)，你在这里直接编辑文件。
      • 暂存区 (Staging Area / Index): 位于 .git 目录中。这是一个临时区域，用于存放你打算包含在下一次提交（commit）中的文件修改。
      • 版本库 (Repository): 同样位于 .git 目录中。这里存储了项目的所有提交历史、分支信息等。当你执行 git commit 时，暂存区的内容会被永久性地记录到版本库中，形成一个新的版本（快照）。

  4. 创建和修改文件

    • 在 my-first-project 目录下创建一个简单的文本文件，例如 README.md。（.md 是Markdown文件的扩展名，常用于编写说明文档）。

    • 使用文本编辑器打开 README.md，输入一些内容，比如：
      “`markdown
      # My First Project

      This is the README file for my first Git project.
      “`
      * 保存文件。

  5. 查看状态 (git status)

    • 现在，回到命令行，运行：
      bash
      git status

    • 你会看到类似以下的输出：
      “`
      On branch main # 或者 master，取决于你的Git版本和配置
      No commits yet
      Untracked files:
      (use “git add …” to include in what will be committed)
      README.md

      nothing added to commit but untracked files present (use “git add” to track)
      ``
      *      git status是你最常用的Git命令之一。它告诉你当前仓库的状态：
      * 你在哪个分支上 (      On branch main)。
      * 是否有尚未提交的更改。
      *      Untracked files:列出了工作区中新创建的、Git尚未开始跟踪的文件 (README.md`)。

  6. 添加到暂存区 (git add)

    • 要让Git开始跟踪 README.md 文件，并准备将其包含在下一次提交中，我们需要使用 git add 命令将其添加到暂存区：
      bash
      git add README.md
    • 如果你想添加当前目录下所有已修改或新创建的文件，可以使用：
      bash
      git add .
    • 现在再运行 git status：
      On branch main
      No commits yet
      Changes to be committed:
      (use "git rm --cached <file>..." to unstage)
      new file: README.md
    • 看到 Changes to be committed: 下列出了 README.md，说明它已经被成功添加到暂存区了。

  7. 提交到版本库 (git commit)

    • 暂存区准备好后，我们就可以将这些更改永久记录到版本库中了，这称为一次“提交”（Commit）。每次提交都需要附带一条提交信息（Commit Message），用来说明这次提交做了什么修改。
    • 运行以下命令：
      bash
      git commit -m "Initial commit: Add README file"
    • -m 参数后面跟着的是用双引号括起来的提交信息。写好提交信息非常重要，它应该简洁明了地描述这次更改的目的。
    • 提交成功后，你会看到类似输出，告诉你哪个分支被提交了，提交的SHA-1哈希值（唯一标识符）是什么，以及有多少文件被更改。
    • 现在再运行 git status：
      On branch main
      nothing to commit, working tree clean
    • 这表示你的工作区和暂存区都是“干净”的，所有更改都已保存到版本库中。

  8. 查看提交历史 (git log)

    • 要查看项目的提交历史记录，使用 git log 命令：
      bash
      git log
    • 你会看到刚才的提交记录，包括作者、日期、提交信息和唯一的commit ID（SHA-1哈希值）。
    • git log 有很多有用的选项，例如：
      • git log --oneline: 以简洁的单行格式显示历史。
      • git log --graph: 以图形化方式显示分支合并历史。
      • git log -p: 显示每次提交的具体内容差异。

恭喜！你已经成功在本地创建了一个Git仓库，并完成了你的第一次文件跟踪和提交。

第四部分：连接远程——将本地仓库推送到GitHub

现在，我们要把本地的项目备份到GitHub上，并为将来的协作做准备。

  1. 在GitHub上创建远程仓库

    • 登录你的GitHub账户。
    • 点击页面右上角的 “+” 图标，选择 “New repository”。
    • Repository name: 输入一个仓库名称，通常建议与你的本地项目文件夹名称一致，例如 my-first-project。
    • Description (optional): 添加一个简短的项目描述。
    • Public / Private: 选择仓库的可见性。Public仓库任何人都可以看到，Private仓库只有你和你授权的人能看到（GitHub免费账户现在也允许创建无限的私有仓库，但协作者数量有限制）。对于学习和开源项目，通常选择Public。
    • Initialize this repository with: 非常重要！ 因为我们本地已经有了一个包含提交历史的仓库，所以不要勾选 “Add a README file”, “Add .gitignore”, 或 “Choose a license”。如果勾选了这些，GitHub会创建一个带有初始提交的仓库，这会与你本地的仓库历史冲突，导致后续推送困难。我们要创建一个空的远程仓库。
    • 点击 “Create repository”。

  2. 关联本地仓库与远程仓库 (git remote add)

    • 创建成功后，GitHub会显示一个页面，其中包含了一些指令，告诉你如何将本地仓库连接到这个新创建的远程仓库。找到 “…or push an existing repository from the command line” 部分。
    • 复制其中的 git remote add origin ... 命令。它看起来像这样（your-username 替换为你的GitHub用户名）：
      bash
      git remote add origin https://github.com/your-username/my-first-project.git
      或者使用SSH协议（如果你配置了SSH密钥）：
      bash
      git remote add origin [email protected]:your-username/my-first-project.git
      对于初学者，HTTPS通常更简单。
    • 回到你的本地项目目录的命令行，粘贴并运行这条命令。
    • 解释：
      • git remote add: 这是添加一个远程仓库连接的命令。
      • origin: 这是你为这个远程仓库起的别名。origin 是Git社区默认的、最常用的远程仓库别名，指向你项目的主要托管地址（通常是你自己创建的那个）。你可以有多个远程仓库连接，并给它们不同的别名。
      • https://... 或 git@...: 这是远程仓库的URL地址。

  3. 验证远程连接 (git remote -v)

    • 运行以下命令查看已配置的远程仓库：
      bash
      git remote -v
    • 你应该能看到名为 origin 的远程仓库及其对应的URL（用于fetch和push）。

  4. 推送本地更改到远程仓库 (git push)

    • 现在，我们要将本地仓库 main（或 master）分支上的所有提交推送到名为 origin 的远程仓库中。
    • 运行以下命令：
      bash
      git push -u origin main

      • 注意: 你的默认分支可能是 main（较新的Git版本默认）或 master（较老的版本默认）。请根据 git status 或 git branch 的输出来确定你的主分支名称。如果你的主分支是 master，请将命令中的 main 替换为 master。
    • 解释：
      • git push: 推送命令。
      • -u (或 --set-upstream): 这个选项是第一次推送时推荐使用的。它做了两件事：1) 将本地的 main 分支内容推送到 origin 远程仓库对应的 main 分支；2) 将本地的 main 分支与远程的 origin/main 分支关联起来。这样设置之后，未来当你在本地 main 分支上时，可以直接使用 git push（无需指定 origin 和 main）来推送，以及使用 git pull 来拉取更新。
      • origin: 指定要推送到的远程仓库别名。
      • main: 指定要推送的本地分支名称。
    • 认证： 当你第一次通过HTTPS向GitHub推送时，系统可能会提示你输入GitHub的用户名和密码，或者使用Personal Access Token（推荐，更安全）。按照提示操作完成认证。如果使用SSH，并且你已经正确配置了SSH密钥，则通常不需要额外认证。
    • 推送成功后，刷新你在GitHub上创建的仓库页面，你会看到你的 README.md 文件以及提交历史已经出现在那里了！

第五部分：日常工作流——修改、提交、推送与拉取

现在你已经建立了本地与远程仓库的连接，我们来看看日常开发中常用的流程。

  1. 修改文件 -> 添加 -> 提交 (本地)

    • 继续在本地 my-first-project 目录下工作。比如，修改 README.md 文件，添加更多内容。
    • 保存文件后，运行 git status 查看更改。你会看到 README.md 被列为 modified。
    • 使用 git add README.md (或 git add .) 将修改添加到暂存区。
    • 使用 git commit -m "Update README with more details" 提交更改到本地版本库。

  2. 推送更改到GitHub (git push)

    • 由于之前使用了 -u 选项，现在你只需要运行：
      bash
      git push
    • Git会自动将当前本地分支（main）的最新提交推送到与之关联的远程分支（origin/main）。
    • 再次刷新GitHub仓库页面，你会看到最新的修改。

  3. 克隆远程仓库 (git clone)

    • 假设你在另一台电脑上，或者想让其他人获取你的项目。他们需要将GitHub上的仓库“克隆”（Clone）到本地。
    • 首先，在GitHub仓库页面，点击绿色的 “Code” 按钮，复制仓库的URL（HTTPS或SSH）。
    • 在你的本地计算机上，打开命令行，cd 到你想要存放项目的父目录（不要进入已有的 my-first-project 目录！），然后运行：
      bash
      git clone https://github.com/your-username/my-first-project.git
      （将URL替换为你复制的地址）
    • 这会在当前目录下创建一个名为 my-first-project 的新文件夹，其中包含了GitHub仓库的所有文件和完整的Git历史记录。并且，它自动设置了名为 origin 的远程连接，指向你克隆的源仓库。

  4. 拉取远程更改 (git pull)

    • 如果你在多台电脑上工作，或者与他人协作，你需要确保你的本地仓库与远程仓库保持同步。当远程仓库有了你本地没有的更新时（比如你在另一台电脑推送了更改，或者协作者推送了更改），你需要将这些更新拉取到本地。
    • 进入你的本地仓库目录 (my-first-project)，运行：
      bash
      git pull origin main
      （同样，如果主分支是 master，则用 master）
    • 由于克隆时或首次推送时设置了上游分支关联，通常你也可以直接简化为：
      bash
      git pull
    • git pull 命令实际上是两个命令的组合：git fetch（从远程仓库下载最新的历史记录和对象，但不合并到你的工作区）和 git merge（将远程分支的更改合并到你当前的本地分支）。
    • 如果本地有未提交的更改与远程拉下来的更改冲突，git pull 可能会失败，并提示你先处理本地更改（提交、暂存或丢弃）。

第六部分：协作基础——分支、合并与Pull Request

Git最强大的功能之一就是分支管理。分支允许你偏离主开发线（通常是 main 或 master），独立地进行工作（如开发新功能、修复Bug），而不会影响到主线的稳定性。完成后，再将分支上的工作合并回主线。

  1. 创建分支 (git branch / git checkout -b)

    • 假设你要开发一个新功能，比如添加一个 LICENSE 文件。最好在一个新的分支上进行。
    • 创建一个名为 add-license 的新分支：
      bash
      git branch add-license
      这只是创建了分支，你当前仍然在 main 分支上。
    • 切换到新创建的分支：
      bash
      git checkout add-license
    • 或者，更常用的是一步完成创建并切换：
      bash
      git checkout -b add-license
    • 现在，你所有的修改都将在 add-license 分支上进行，不会影响 main 分支。运行 git status 或 git branch 可以确认你当前所在的分支。

  2. 在分支上工作 (添加、提交)

    • 在 add-license 分支上，创建一个 LICENSE 文件（例如，选择一个开源协议如MIT，并将内容粘贴进去）。
    • 保存文件。
    • 使用 git add LICENSE 和 git commit -m "Add MIT License" 提交更改。这个提交只存在于 add-license 分支上。

  3. 推送分支到GitHub

    • 将你的新分支推送到远程仓库 origin，这样其他人也能看到，或者你可以在GitHub上发起Pull Request：
      bash
      git push origin add-license
    • (可选) 同样可以使用 -u 选项来设置上游关联：git push -u origin add-license。

  4. 创建Pull Request (PR)

    • 这是GitHub协作的核心。当你完成了一个功能或修复，并希望将其合并到主分支（如 main）时，你可以在GitHub上创建一个Pull Request。
    • 推送分支后，访问你的GitHub仓库页面。通常GitHub会自动检测到你推送了新分支，并显示一个黄色的提示条，让你方便地点击 “Compare & pull request”。
    • 如果没有提示，可以手动切换到 add-license 分支，然后点击 “Pull request” 或 “Contribute” -> “Open pull request”。
    • 在打开的PR页面：
      • Base repository/branch: 确认是要合并到的目标仓库和分支（通常是你的仓库的 main 分支）。
      • Head repository/branch: 确认是包含你更改的源仓库和分支（你的仓库的 add-license 分支）。
      • Title & Description: 填写清晰的标题和描述，解释这个PR做了什么，为什么需要合并。可以 @ 提及相关的同事请求审查。
      • Reviewers/Assignees: (可选) 指定审查者或负责人。
      • 点击 “Create pull request”。

  5. 代码审查与合并 (在GitHub上)

    • 创建PR后，你（或团队成员）可以在PR页面查看代码差异、发表评论、进行讨论。
    • 如果需要修改，你可以在本地 add-license 分支上继续提交，然后 git push origin add-license，这些新的提交会自动更新到PR中。
    • 当代码审查通过，且没有冲突时，拥有合并权限的人（通常是仓库所有者或维护者）可以在PR页面点击 “Merge pull request” 按钮。
    • GitHub提供了几种合并方式（Merge commit, Squash and merge, Rebase and merge），对于初学者，默认的 “Merge commit” 即可。
    • 合并后，add-license 分支上的所有更改就都包含在 main 分支中了。

  6. 同步本地主分支并删除已合并分支

    • PR合并后，你的本地 main 分支还是旧的。需要切换回 main 分支并拉取远程的最新更改：
      bash
      git checkout main
      git pull origin main # 或者 git pull
    • 现在你的本地 main 分支也包含了 LICENSE 文件。
    • 合并后的特性分支通常就不再需要了。可以先删除远程分支（在GitHub的PR页面合并后通常有删除按钮，或者在本地使用命令）：
      bash
      git push origin --delete add-license
    • 然后删除本地分支：
      bash
      git branch -d add-license
      (-d 只会删除已完全合并的分支，如果未合并想强制删除用 -D)

第七部分：其他常用GitHub特性

  • .gitignore 文件: 在项目根目录下创建一个名为 .gitignore 的文本文件。在里面列出你不希望Git跟踪的文件或目录模式（例如编译产生的文件 *.o, *.class，依赖包目录 /node_modules，操作系统生成的文件 .DS_Store 等）。Git会自动忽略这些文件。
  • README.md: 良好的README是项目的门面。使用Markdown语法编写清晰的项目介绍、安装指南、使用方法等。GitHub会自动在仓库首页展示README的内容。
  • Issues: 用于跟踪Bug、提出功能建议、讨论问题。每个Issue可以被分配、打标签、关联到PR。
  • Forking: 如果你想为一个不属于你的公开项目贡献代码，通常的流程是：
    1. 在GitHub上 “Fork” 目标仓库到你自己的账户下（创建一份你自己的副本）。
    2. git clone 你Fork的仓库到本地。
    3. 创建新分支进行修改。
    4. git push 分支到你自己的Fork仓库。
    5. 在你Fork的仓库页面，向原始仓库（称为 “upstream”）发起Pull Request。

第八部分：总结与后续学习

恭喜你！通过本教程，你已经掌握了Git和GitHub最核心的基础知识和操作流程：

  • 理解了Git和GitHub的概念与关系。
  • 安装并配置了Git。
  • 创建了本地Git仓库，并进行了添加、提交操作。
  • 在GitHub上创建了远程仓库，并将本地仓库与之关联、推送。
  • 学会了日常的修改、提交、推送、克隆和拉取流程。
  • 了解了分支的基本概念，并实践了创建分支、在分支上工作、推送分支。
  • 理解了Pull Request的核心协作模式。

这仅仅是冰山一角。Git和GitHub的世界非常广阔，还有许多高级功能和最佳实践等待你去探索，例如：

  • 解决合并冲突（Merge Conflicts）。
  • git rebase：另一种合并分支的方式，可以使提交历史更线性。
  • git tag：为重要的提交（如版本发布）打上标签。
  • git stash：临时保存未完成的更改。
  • 更复杂的分支策略（如Gitflow）。
  • GitHub Actions：自动化构建、测试、部署等工作流。
  • GitHub Pages：免费托管静态网站。
  • 使用SSH密钥进行更安全的认证。

持续实践是关键。 尝试将你自己的项目（无论是代码、笔记、文档还是配置文件）用Git管理起来，并推送到GitHub。参与到简单的开源项目中，哪怕只是修改一个错别字并发起一个PR，都是宝贵的实践经验。

Git和GitHub是现代开发者和协作者的必备技能。熟练掌握它们，将极大地提高你的工作效率，拓宽你的职业道路，并让你能够更顺畅地融入全球性的技术社区。祝你在Git和GitHub的学习之路上一切顺利！

发表评论

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

滚动至顶部