跳至主要内容

开始使用你的 GitHub 账户

使用 GitHub 个人账户,您可以导入或创建仓库,与他人协作,并与 GitHub 社区连接。

本指南将引导您完成 GitHub 账户的设置,并开始使用 GitHub 的协作与社区功能。

第 1 部分:配置您的 GitHub 账户

在 GitHub 开始的首要步骤包括创建账户、选择最适合您需求的产品、验证您的电子邮件、设置双因素认证以及查看您的个人资料。

GitHub 上有多种账户类型。每个使用 GitHub 的人都有自己的个人账户,可加入多个组织和团队。您的个人账户是您在 GitHub.com 上的身份,代表您本人。

1. 创建账户

要注册账户,请访问 https://github.com/ 并按提示操作。

为确保您的 GitHub 账户安全,您应使用强且唯一的密码。详情请参阅 创建强密码

2. 选择您的 GitHub 产品

您可以选择 GitHub 免费版或 GitHub 专业版,以获取个人账户的不同功能。如果您一开始不确定选择哪种产品,随时可以升级。

有关 GitHub 所有计划的更多信息,请参阅 GitHub 计划

3. 验证您的电子邮件地址

为确保您可以使用 GitHub 计划中的全部功能,请在注册新账户后验证您的电子邮件地址。更多信息,请参阅 验证您的电子邮件地址

4. 配置双因素认证

双因素认证(2FA)是登录网站或应用时使用的额外安全层。我们强烈建议您配置 2FA 以确保账户安全。更多信息,请参阅 关于双因素认证

可选地,在配置 2FA 后,您可以向账户添加通行密钥,实现安全的无密码登录。请参阅 管理通行密钥

5. 查看您的 GitHub 个人资料和贡献图

您的 GitHub 个人资料通过您置顶的仓库和代码片段、公开的组织成员身份、所做的贡献以及创建的项目,向他人展示您的工作历程。更多信息,请参阅 关于您的个人资料在个人资料上查看贡献

第 2 部分:使用 GitHub 的工具和流程

要充分利用 GitHub,您需要配置 Git。Git 负责在本地计算机上执行与 GitHub 相关的所有操作。要在 GitHub 上高效协作,您需要使用 GitHub 风格的 Markdown 在议题和拉取请求中进行编写。

1. 学习 Git

GitHub 的协作开发方式依赖于将本地仓库的提交推送到 GitHub,供其他人查看、获取和更新。有关 Git 的更多信息,请参阅 Git 手册。有关 Git 在 GitHub 上的使用方式,请参阅 GitHub flow

2. 设置 Git

如果您计划在本地计算机上使用 Git,无论是通过命令行、IDE 还是文本编辑器,都需要安装并配置 Git。更多信息,请参阅 设置 Git

如果您更喜欢使用可视化界面,可以下载并使用 GitHub Desktop。GitHub Desktop 已内置 Git,无需单独安装 Git。更多信息,请参阅 GitHub Desktop 入门

安装 Git 后,您即可从本地计算机连接到 GitHub 上的仓库,无论是您自己的仓库还是其他用户的分叉。当您通过 Git 从 GitHub.com 连接仓库时,需要使用 HTTPS 或 SSH 进行身份验证。更多信息,请参阅 关于远程仓库

3. 选择与 GitHub 交互的方式

每个人都有自己独特的与 GitHub 交互的工作流;您使用的界面和方法取决于个人偏好以及最适合您需求的方式。

有关与 GitHub 交互的不同方法以及可使用工具的比较,请参阅 连接到 GitHub

4. 在 GitHub 上写作

要在议题和拉取请求中清晰、有组织地进行沟通,您可以使用 GitHub 风格的 Markdown 进行格式化,它融合了易读、易写的语法和一些自定义功能。更多信息,请参阅 关于在 GitHub 上的写作与格式化

您可以通过 使用 Markdown 进行交流 课程学习 GitHub 风格的 Markdown。

5. 在 GitHub 上搜索

我们的集成搜索可帮助您在 GitHub 上的众多仓库、用户和代码行中找到所需内容。您可以在整个 GitHub 范围内进行全局搜索,或将搜索限制在特定仓库或组织内。更多关于在 GitHub 上可以进行的搜索类型,请参阅 关于在 GitHub 上搜索

我们的搜索语法允许您使用限定符构建查询,以指定搜索内容。有关搜索语法的更多信息,请参阅 在 GitHub 上搜索

6. 在 GitHub 上管理文件

使用 GitHub,您可以在自己的仓库或任何拥有写权限的仓库中创建、编辑、移动和删除文件,还可以逐行跟踪文件的更改历史。更多信息,请参阅 管理文件

第 3 部分:在 GitHub 上协作

任意数量的人都可以在 GitHub 的仓库中共同工作。您可以配置设置、创建项目并管理通知,以促进有效协作。

1. 使用仓库

创建仓库

仓库类似于项目的文件夹。您可以在个人账户中拥有任意数量的公开和私有仓库。仓库可以包含文件夹、文件、图片、视频、电子表格和数据集,以及所有文件的修订历史。更多信息,请参阅 关于仓库

创建新仓库时,您应使用 README 文件进行初始化,以便让他人了解您的项目。更多信息,请参阅 创建新仓库

克隆仓库

您可以将 GitHub 上的现有仓库克隆到本地计算机,这样更容易添加或删除文件、解决合并冲突或进行复杂的提交。克隆仓库会拉取 GitHub 当时的完整数据副本,包括项目中每个文件和文件夹的所有版本。更多信息,请参阅 克隆仓库

分叉仓库

分叉是您管理的仓库副本,您所做的更改不会影响原始仓库,除非您向项目所有者提交拉取请求。通常,分叉用于向他人的项目提出更改建议或将他人的项目作为自己创意的起点。更多信息,请参阅 使用分叉

2. 导入您的项目

如果您有现有项目想迁移到 GitHub,可以使用 GitHub Importer、命令行或外部迁移工具进行导入。更多信息,请参阅 导入源代码

3. 管理协作者和权限

您可以使用仓库的议题、拉取请求和项目与他人协作。您可以在仓库设置的 Collaborators 选项卡中邀请他人作为协作者。更多信息,请参阅 邀请协作者到个人仓库

您是个人账户中创建的任何仓库的所有者,拥有对仓库的全部控制权。协作者对您的仓库拥有写入权限,限制了他们的操作权限。更多信息,请参阅 个人账户仓库的权限级别

4. 管理仓库设置

作为仓库所有者,您可以配置多项设置,包括仓库的可见性、主题和社交媒体预览。更多信息,请参阅 管理仓库的设置和功能

5. 为健康贡献设置您的项目

要鼓励仓库中的协作者,您需要一个鼓励人们使用、贡献并推广您项目的社区。更多信息,请参阅 打造友好社区(Open Source Guides)。

通过向仓库添加贡献指南、行为准则和许可证等文件,您可以营造一个更易于协作者作出有意义、有价值贡献的环境。更多信息,请参阅 为健康贡献设置您的项目

6. 使用 GitHub 议题和项目

您可以使用 GitHub 议题来组织工作,并使用项目来管理工作流。更多信息,请参阅 关于议题关于项目

7. 管理通知

通知会提供您已订阅或参与的 GitHub 活动的更新。如果您对某个对话不再感兴趣,可以取消订阅、取消关注,或自定义将来接收的通知类型。更多信息,请参阅 关于通知

8. 使用 GitHub Pages

您可以使用 GitHub Pages 直接从 GitHub.com 上的仓库创建并托管网站。更多信息,请参阅 GitHub Pages 是什么?

9. 使用 GitHub Discussions

您可以为仓库启用 GitHub Discussions,以帮助围绕项目构建社区。维护者、贡献者和访客可以使用讨论发布公告、提问解答以及围绕目标进行对话。更多信息,请参阅 关于 Discussions

第 4 部分:自定义和自动化您在 GitHub 上的工作

您可以使用 GitHub Marketplace 中的工具、GitHub API 以及现有的 GitHub 功能来自定义和自动化您的工作。

1. 使用 GitHub Marketplace

GitHub Marketplace 包含可增强功能并改进工作流的集成。您可以在 GitHub Marketplace 中发现、浏览并安装免费或付费工具,包括 GitHub 应用、OAuth 应用和 GitHub Actions。

2. 使用 GitHub API

GitHub API 有两个版本:REST API 和 GraphQL API。您可以使用这些 API 自动化常见任务、备份您的数据,或创建集成以扩展 GitHub。更多信息,请参阅 比较 GitHub 的 REST API 与 GraphQL API

3. 构建 GitHub Actions

通过 GitHub Actions,您可以在 GitHub 上自动化并自定义企业的开发工作流。您可以创建自己的 Action,亦可使用并自定义社区共享的 Action。更多信息,请参阅 编写工作流

4. 发布和管理 GitHub Packages

GitHub Packages 是一项软件包托管服务,允许您私有或公开托管软件包,并在项目中将其用作依赖项。更多信息,请参阅 GitHub Packages 介绍

第 5 部分:在 GitHub 上安全构建

GitHub 提供多种安全功能,帮助在仓库中保护代码和机密。部分功能对所有仓库可用,另一些仅对公共仓库以及拥有 GitHub Code Security 或 GitHub Secret Protection 许可证的仓库可用。有关安全功能概览,请参阅 GitHub 安全功能

1. 保护您的仓库

作为仓库管理员,您可以通过配置仓库安全设置来保护仓库。这包括管理对仓库的访问、设置安全策略以及管理依赖项。对于公共仓库,以及拥有相应许可证的组织私有仓库,您还可以配置代码和机密扫描,以自动识别漏洞并确保令牌和密钥不被泄露。

有关保护仓库的步骤的更多信息,请参阅 仓库安全快速入门

2. 管理您的依赖项

安全构建的重要组成部分是维护项目的依赖项,确保所有依赖的包和应用程序均已更新且安全。您可以通过在 GitHub 上查看仓库的依赖图、使用 Dependabot 自动发起拉取请求来保持依赖项最新,并接收 Dependabot 警报和安全更新以处理有漏洞的依赖项。

更多信息,请参阅 保护供应链

第 6 部分:参与 GitHub 社区

参与 GitHub 社区的方式有很多。您可以为开源项目做贡献、在 GitHub 社区支持中与人互动,或通过 GitHub Skills 学习。

1. 为开源项目做贡献

在 GitHub 上为开源项目做贡献是学习、教学并积累几乎所有技能经验的有益方式。更多信息,请参阅 Open Source Guides 中的 如何为开源做贡献

您可以在 Explore GitHub 中根据过去的贡献、收藏和其他活动找到个性化的项目和适合新手的议题推荐。更多信息,请参阅 在 GitHub 上寻找为开源做贡献的方式

2. 与 GitHub 社区支持互动

您可以与全球开发者联系,提问和解答、学习,并直接与 GitHub 员工互动。要开始交流,请访问 GitHub Community Support

3. 在 GitHub Docs 上阅读关于 GitHub 的内容

您可以阅读与您当前使用的 GitHub 产品相对应的文档。更多信息,请参阅 关于 GitHub Docs 的版本

4. 通过 GitHub Skills 学习

您可以通过在自己的 GitHub 仓库中完成有趣且真实的项目,使用 GitHub Skills 学习新技能。每门课程都是由 GitHub 社区创建并由友好的机器人授课的实践课程。

更多信息,请参阅 Git 与 GitHub 学习资源

5. 支持开源社区

GitHub Sponsors 允许您每月向设计、创建或维护您所依赖的开源项目的开发者或组织进行定期付款。更多信息,请参阅 关于 GitHub Sponsors

6. 联系 GitHub 支持

GitHub 支持能够帮助您排查在使用 GitHub 过程中遇到的问题。更多信息,请参阅 关于 GitHub 支持

延伸阅读

© . This site is unofficial and not affiliated with GitHub, Inc.