GitHub 入门

引言：为什么是GitHub？

在软件开发的星辰大海中，GitHub 无疑是那颗最耀眼的北极星。它不仅仅是全球最大的代码托管平台，更是无数开发者协作、学习、构建的开源圣地。无论你是初出茅庐的编程新手，还是经验丰富的资深工程师，精通GitHub都是一项不可或缺的核心技能。

本文将作为你的终极指南，手把手带你完成GitHub注册、深入理解核心功能、并最终熟练地上传和管理你的代码。我们不仅会讲解“如何做”，更会深入探讨“为何这么做”，分享最佳实践，助你避开常见陷阱，真正将GitHub变为你开发流程中得心应手的利器。

第一章：启程——完美注册GitHub账号

注册账号是第一步，但完美的起步能为后续使用省去很多麻烦。

1.1  访问与注册

1. 打开 GitHub 官方网站：github官网

2. 点击页面中间的 Sign up 按钮。

3. 按照提示填写你的邮箱、用户名、密码。

1.2  关键信息选择策略（重点）

• 用户名 (Username)：

  • 重要性：这是你的身份标识，会显示在你的仓库地址中（如 https://github.com/你的用户名/项目名）。一旦确定，后期更改虽然可行但非常麻烦，所有旧链接都会失效。

  • 选择技巧：

    • 优先使用你的英文名或常用ID，保持专业性和一致性。

    • 检查可用性，确保名字唯一且易记。

    • 避免使用复杂数字串（如user123456），它不利于他人记忆和传播。

• 邮箱 (Email)：

  • 强烈建议使用一个稳定、常用的邮箱地址（如Gmail, Outlook等）。所有重要通知（如合入请求、安全警报）都会发到此邮箱。

  • 验证邮箱是必须步骤，否则无法创建仓库等功能。

1.3  个性化设置与初步探索

完成邮箱验证后，GitHub会问你几个问题（如身份、兴趣等），你可以根据情况填写或跳过。之后，你会进入主页。花几分钟时间熟悉一下界面：

• 左侧面板：你的仓库、收藏夹、团队列表。

• 中间信息流：你关注的人和仓库的动态。

• 右上角：通知中心、个人头像（用于设置）。

最佳实践：点击你的头像 -> Settings -> Emails，确认你的主邮箱，并考虑勾选 Keep my email addresses private（保护隐私）和 Block command line pushes that expose my email（防止命令行泄露邮箱），这能有效减少垃圾邮件。

第二章：奠基——GitHub核心概念与界面精通

要玩转GitHub，必须先理解其核心概念，这是获得高分质量文章的关键。

2.1  核心概念解析

• 仓库 (Repository, 简称Repo)：

  • 是什么：一个项目的“文件夹”，包含了所有的项目文件、修订历史、配置信息等。它是GitHub最基本的单位。

  • 分类：分为公开 (Public)（所有人可见，可免费创建）和私有 (Private)（仅你授权的人可见）。

• 克隆 (Clone)：

  • 是什么：将远程服务器上的仓库完整地复制到你的本地计算机的过程。这样你就能在本地编辑代码了。

  • 命令：git clone <仓库地址>

• 提交 (Commit)：

  • 是什么：一次代码的版本快照。就像玩游戏时的存档点。每次提交都需要附上一条简短的说明（Commit message），解释这次做了什么修改。

  • 原则：“小步快跑”，每次提交只做一个明确的修改，并编写清晰的提交信息。

• 推送 (Push)：

  • 是什么：将你在本地仓库中的提交上传到远程GitHub仓库的操作。

• 拉取 (Pull)：

  • 是什么：将远程GitHub仓库的最新更新下载并合并到你本地仓库的操作。在团队协作中，开始工作前先pull是好习惯。

• 分支 (Branch)：

  • 是什么：一条独立的开发线。你可以把项目想象成一棵树，主分支（main 或 master）是树干，功能分支是树枝。在分支上开发新功能不会影响主干 stability。

  • 工作流：经典的 Git Flow 或 Feature Branch Workflow 都基于分支管理。

• 合并请求 (Pull Request, 简称PR)：

  • 是什么：协作的灵魂。当你完成了一个分支的开发，希望将其合并到主分支时，就发起一个PR。其他人可以审查代码 (Code Review)、讨论修改，确认无误后合并。

  • 作用：保证了代码质量，促进了知识共享。

2.2  界面导航与实用功能

• 个人主页：展示你的个人信息、贡献图、置顶仓库等。是你的“开发者名片”。

• 仓库页面：

  • Code： 查看文件结构。

  • Issues： 用于Bug报告、功能提议、任务跟踪。

  • Pull requests： 查看和管理合并请求。

  • Actions： GitHub提供的强大CI/CD（持续集成/持续部署）工具。

  • Settings： 仓库的各种配置，如合作者管理、危险操作等。

第三章：实战——本地连接GitHub与代码上传

这是本文最核心的实战部分。我们将介绍两种主流方法：命令行和桌面版。

3.1  前期准备：安装和配置Git

无论哪种方法，都需要先在本地安装Git。

（1）下载Git：访问https://git-scm.com/，下载并安装对应你操作系统的版本。

（2）全局配置：安装完成后，打开终端（Linux/macOS）或Git Bash（Windows），设置你的用户名和邮箱，这会记录在你的每一次提交中。

git config --global user.name "你的GitHub用户名"git config --global user.email "你的GitHub验证邮箱"

3.2  方法一：命令行（CLI）上传（推荐开发者掌握）

这是几种方式里面最强大、最灵活的方式。

场景一：从本地已有项目初始化并上传

1、本地初始化Git仓库

进入你的项目根目录，右键打开Git Bash here，执行如下操作——

git init

这会在当前目录创建一个.git隐藏文件夹，Git开始跟踪这个项目。

2、连接远程仓库
首先，在GitHub上点击 + -> New repository 创建一个新的空仓库。仓库名最好与本地项目名一致。创建后，复制提供的仓库地址（HTTPS或SSH）。然后在本地执行。

git remote add origin https://github.com/你的用户名/你的仓库名.git

origin是给远程仓库起的一个别名，方便后续操作。

3、添加文件到暂存区

git add .

. 表示添加所有文件。如果只想添加特定文件，可以替换为文件名。

4、提交更改

git commit -m "清晰的提交信息，如：Initial commit"

-m 后面的内容是本次提交的说明，务必清晰扼要。

5、推送到GitHub

git push -u origin main

-u 参数设置了上游分支，下次你在这个分支上只需要输入 git push 即可。

注意： 旧版本Git的默认主分支可能是 master，请根据你的GitHub仓库实际分支名调整（现在新建仓库默认为 main）。

场景二：克隆已有仓库到本地进行协作

如果你要参与别人的项目，或者想在多台电脑上工作，这是标准流程。

1、在GitHub上找到目标仓库，点击绿色的 Code 按钮，复制地址。

2、在本地你想要存放项目的目录下，打开终端执行：

git clone <复制的地址>

3、进入克隆下来的项目文件夹，即可开始开发。之后的流程就是 add -> commit -> push 循环。

3.3  方法二：使用GitHub Desktop（图形化界面，对新手友好）

如果你不习惯命令行，GitHub官方提供了桌面客户端，大大降低了上手门槛。

1. 下载安装：访问GitHub Desktop下载并安装。

2. 认证账号：打开软件，它会引导你登录GitHub账号。

3. 创建/克隆仓库：

   • 克隆现有仓库：File -> Clone repository，从列表中选择或从URL克隆。

   • 创建新仓库：File -> New repository，填写信息并创建。

4. 进行更改并提交：

   • 在本地用任何编辑器修改你的代码文件。

   • 回到GitHub Desktop，左侧会显示所有已更改的文件。

   • 在左下角填写摘要（必填）和描述（选填），这相当于 commit -m。

   • 点击 Commit to main 按钮提交。

5. 推送：提交后，点击界面顶部的 Push origin 按钮，即可将本地提交推送到GitHub。

3.4  高级技巧与最佳实践（97分以上的关键）

1、.gitignore文件：

（1）是什么：一个特殊的文件，里面列出了你不希望被Git跟踪的文件和文件夹（如日志文件、编译产物、本地配置文件、node_modules等）。

（2）如何使用：在项目根目录创建名为 .gitignore 的文件，并按规则填写。GitHub提供了各种语言的模板，创建仓库时可以直接选择，非常方便。

（3）重要性：避免将无关、庞大或敏感的文件上传到公开仓库，是专业性的体现。

2、README.md：

（1）项目的“说明书”，使用Markdown语法编写。一个好的README应包含项目介绍、安装方式、使用方法、如何贡献等。它是你项目的门面。

3、SSH Keys连接（更安全便捷）：

（1）相比HTTPS，SSH免去了每次推送都要输入账号密码的麻烦。

（2）生成SSH Key：在终端运行 ssh-keygen -t ed25519 -C "your_email@example.com"（一路回车）。

（3）添加公钥到GitHub：复制 ~/.ssh/id_ed25519.pub 文件的内容，在GitHub设置中 SSH and GPG keys 页面添加新的SSH Key。

（4）将远程仓库地址改为SSH：git remote set-url origin git@github.com:用户名/仓库名.git。

第四章：超越——GitHub生态与协作艺术

真正的力量来自于协作。

• Fork (复刻) + Pull Request (PR)：这是参与开源项目的标准流程。

  1. 在GitHub上找到你感兴趣的项目，点击右上角的 Fork 按钮。这会在你的账号下创建一个该项目的副本。

  2. 将你Fork后的仓库 Clone 到本地。

  3. 创建一个新的功能分支（git checkout -b my-new-feature）。

  4. 开发、测试、提交。

  5. 推送到你的Fork仓库（git push origin my-new-feature）。

  6. 在你Fork的仓库页面上，会出现 Compare & pull request 的按钮，点击它向原始项目发起PR。

  7. 等待项目维护者审查并合并你的代码。

• GitHub Pages：可以直接从仓库托管你的个人或项目静态网站（博客、文档、简历等），免费且极其方便。

• GitHub Actions：内置的CI/CD工具，可以自动化你的测试、部署流程。例如，每次 push 代码后自动运行测试套件，或自动部署到服务器。

结语

GitHub远不止是一个代码备份网盘。它是一套完整的开发工作流，一个庞大的开源社区，一张全球程序员的技术名片。从注册到提交你的第一行代码，这只是开始。不断地探索、参与、贡献，你将会真正融入这个伟大的开发者共同体，从中获得无尽的成长与机会。

现在，就去创建你的第一个仓库，写下你的 Hello, World! 吧！

本文转自 https://blog.csdn.net/2401_89899187/article/details/150849001?spm=1001.2014.3001.5501本人仅做重新排版和错误修正.