Skip to content

GitHub 入门:从注册账号到完成第一次协作

GitHub 是保存项目文件、记录修改并与团队成员协作的平台。第一次使用不必安装 Git:注册账号后,可以直接在浏览器里创建仓库、修改文件、提出 Pull Request,再把修改合并回主分支。本篇以这个闭环为目标;完成后,读者应能看懂一个项目的基本页面,并知道下一次修改从哪里开始。GitHub 官方入门说明Hello World 练习提供了本文的操作依据。

本文核对的是 2026-09-16 可访问的 GitHub.com 文档。下述网页操作是文档核对路径,没有使用真实账号完成注册、提交或合并;界面文字和方案权益变化时,以 GitHub 当前页面为准。

Git、GitHub 和仓库分别是什么

Git 是记录文件版本的工具;GitHub 在 Git 的基础上提供远程仓库、协作讨论、代码审阅和自动化等服务。把文件上传 GitHub 不会自动让项目成为开源软件,也不会替你判断代码是否正确。仓库(repository)是一个项目的文件及其修改历史的容器:文档、程序、配置和网页都可以放进去。

初次浏览仓库时,先看仓库说明 README.md,再看文件列表、最近提交和项目的许可证。README 说明项目要解决什么问题及如何使用;许可证决定别人能否以及如何复用其中的作品。仓库设为公开只表示别人能够查看,不等于没有许可证也可以随意复制、修改或商用

名称在一次修改中扮演的角色直观理解
Commit(提交)保存一次有说明的修改一条可追溯的版本记录
Branch(分支)在不直接改动主线的情况下修改从当前版本分出一条工作线
Pull Request(PR)请求审阅并合入某条分支展示文件差异、供协作者讨论的申请
Issue记录问题、需求或待办事项一条可分配、可讨论的任务

仓库常以 main 作为默认分支,但名称以项目实际设置为准。建立新分支不会立即改变 main;PR 合并后,修改才进入目标分支。GitHub 的 Hello World 用同一条路径解释了仓库、分支、提交和 PR。

GitHub 能做什么

想完成的事常见入口结果与边界
保存和分享项目Repository、README文件和历史可在网页浏览;公开范围由仓库可见性决定
协作修改Branch、Pull requests先审阅差异,再决定是否合并
跟踪问题和讨论Issues、Discussions具体任务适合 Issue;开放式交流可用 Discussions,前提是项目启用了相应功能
规划工作Projects按待办、负责人和状态组织事项
自动检查和交付Actions由工作流执行测试、构建或发布;运行额度和权限需要单独核对
分享可下载版本Releases为某个版本提供说明和可下载产物
发布静态网页Pages发布文档、作品集或前端静态文件,不是通用后端服务器

阅读别人的项目时,Star 是收藏或表达关注,Watch 决定接收何种仓库通知,Fork 是在自己的账号下建立一个仓库副本,Clone 是把仓库复制到本地电脑。这四种操作不是提交修改的必经步骤;本篇练习只需浏览器。

注册并保护账号

  1. 打开 GitHub 注册页,按页面提示创建个人账号。使用自己能收取邮件的邮箱,并设置唯一密码;网页上的第三方登录选项以当时页面为准。
  2. 完成邮箱验证。GitHub 的账号创建说明指出,未验证邮箱会影响创建仓库等基础操作。如果一直收不到邮件,检查垃圾邮件目录,并从账号设置中重新发起验证。
  3. 在账号安全设置中启用双重身份验证(2FA),并按官方引导安全保存恢复方式。不要把密码、恢复码或访问令牌写进仓库。

个人账号属于你自己;组织账号用于多人管理仓库和权限。初学者先用个人账号练习即可,加入团队时再按组织邀请和权限要求操作。GitHub 有免费与付费方案,私有仓库、Actions 额度和其他高级能力的细节应按当前方案页面核对,不能仅凭仓库公开与否推断所有功能免费。

在网页完成第一次协作

以下操作只会修改你自己新建的练习仓库。界面控件可能调整,但每步的目标和成功信号不变。官方 Hello World明确说明,这个练习无需事先学习命令行或安装 Git。

创建仓库

登录后在右上角选择 New repository,将名称设为 hello-github,选择 Private,勾选 Add a README file,然后创建仓库。私人练习用私有仓库可以减少无意公开的信息;今后需要展示作品时,再仔细审查内容并选择公开仓库。

创建成功后,仓库首页应出现 README.md 和默认分支。若创建按钮不可用,先确认邮箱已验证,并检查表单中仓库名称是否与已有仓库冲突。

建立工作分支并提交修改

在仓库 Code 页点击文件列表上方的分支下拉框,输入 readme-intro,从当前默认分支创建新分支。确认当前分支显示为 readme-intro 后,打开 README.md,点击编辑按钮,在原有标题下加入一段介绍,例如“这是我用于练习 GitHub 协作的仓库”。

选择 Commit changes,写一条能说明改动的消息,例如 Add repository introduction,并确认提交到 readme-intro。提交完成后,文件内容和最近提交记录应当变化;切回默认分支时,新介绍暂时不出现。这个差异正是分支隔离的效果。

提出并合并 Pull Request

在仓库 Pull requests 页创建新 PR,检查 base 是默认分支、comparereadme-intro。先读差异页,确认只有预期的 README 修改,再填写标题和简短说明并创建 PR。单人练习也可以用 PR 检查变更;团队项目则通常在这里请求审阅和讨论。

确认没有误改后,使用页面上的合并操作并再次确认。返回默认分支查看 README.md:新介绍已经出现,PR 状态显示已合并,练习才算完成。若合并按钮不可用,查看页面提示:可能存在冲突、检查未通过或仓库设置要求审阅,不应绕过团队规则。练习分支可在合并后删除;提交和 PR 的历史仍可查阅。

找到项目并参与其中

在 GitHub 搜索项目名称或主题后,先阅读 README、许可证和贡献指南,再查看最近提交、开放的 Issues 与 PR。阅读公开代码不要求 Fork;想提出问题可以按项目约定创建 Issue;想修改别人的项目,通常先 Fork,在自己的副本中建分支,再向原仓库提交 PR。对自己有直接写入权限的仓库,则可以直接在仓库的工作分支上协作。GitHub flow说明了从分支到 PR、审阅和合并的协作路径。

项目可能要求先讨论方案、通过自动检查或遵守代码规范。贡献指南和仓库的实际权限优先于通用步骤;Fork 也不会自动授予你修改原仓库的权限。

常见问题和使用边界

现象或疑问先检查什么
不能创建仓库邮箱验证、账号限制、仓库名称,以及页面给出的具体错误
修改后默认分支看不到内容当前查看的是哪个分支;提交是否只在工作分支;PR 是否已合并
PR 出现很多意外改动PR 的 base/compare 是否选反;工作分支是否混入无关提交
担心公开代码泄露信息提交前检查邮箱、令牌、配置和截图;私有仓库也不应存放真实密钥
想使用别人的公开项目先看许可证及贡献指南;能看到源码并不自动获得再分发权

网页端适合建立基本概念和完成小范围修改。需要频繁编辑、多文件操作或离线工作时,再学习本地 Git 或 GitHub Desktop;要发布文档与作品集时,再学习 GitHub Pages。无论使用哪种工具,先确认当前仓库、分支和可见性,再提交内容。

参考资料

全部公开文章由同一个站点构建和发布。