GitHub新手入门 - 从创建仓库到协作管理

GitHub新手入门 - 从创建仓库到协作管理

GitHub 是开发者的社交平台，同时也是代码托管的强大工具。无论是个人项目、开源协作，还是团队开发，GitHub 都能让你轻松管理代码、版本控制和团队协作。今天，我们将从基础开始，带你了解如何在 GitHub 上创建仓库、管理分支、提交 Pull Request 和解决协作中的问题。

1. 介绍与初步配置

1.1 什么是Git和GitHub？
  • Git 是一个分布式版本控制系统，用来记录文件的修改历史，可以追踪和管理源代码的变化。
  • GitHub 是一个基于 Git 的在线平台，允许开发者存储、共享、协作开发项目。你可以把 GitHub 看作是 Git 的云端版。
1.2 版本控制的基本概念

版本控制用于记录文件或代码的变动历史，它帮助你：

  • 追踪所有更改。
  • 在项目中回退到先前版本。
  • 多人协作时避免冲突，合并不同版本的代码。
1.3 注册和设置GitHub账户
  1. 访问 GitHub官网。
  2. 点击右上角的 Sign up，注册一个新的账户。
  3. 按照提示完成账户创建，选择一个用户名并设置密码。
  4. 完成邮箱验证后，你的GitHub账户就创建成功了！
1.4 配置SSH密钥（可选，但推荐）

配置 SSH 密钥可以让你在没有每次输入用户名和密码的情况下推送代码到 GitHub：

  1. 在终端生成 SSH 密钥：
    ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
  2. 将生成的公钥添加到 GitHub：
    • 进入 GitHub 账户设置，找到 SSH and GPG keys。
    • 点击 New SSH key，将你的公钥粘贴进去。

2. 创建仓库与克隆到本地

2.1 如何创建一个新仓库
  1. 登录 GitHub 后，点击右上角的 + 按钮，选择 New repository。
  2. 填写仓库名称（Repository name），可以选择添加描述（Description）。
  3. 选择仓库的可见性：Public（公开）或 Private（私有）。
  4. 勾选 Initialize this repository with a README，这将创建一个初始的 README 文件来描述项目。
  5. 点击 Create repository 完成创建。
2.2 GitHub的仓库结构和界面概述
  • Code：显示所有代码文件。
  • Issues：用于追踪 bugs、任务和功能请求。
  • Pull requests：查看和管理代码提交请求。
  • Actions：用于持续集成和部署的工作流。
  • Projects：管理项目任务和进度。
  • Wiki：用于项目文档的创建和编辑。
2.3 安装Git（Windows/Linux/macOS）
  • Windows：下载安装 Git for Windows，按提示安装。
  • Linux：在终端输入 sudo apt install git（Ubuntu/Debian）或 sudo yum install git（CentOS）。
  • macOS：输入 brew install git（使用 Homebrew）。
2.4 克隆仓库的命令和过程

使用 GitHub 上仓库页面的 Clone or download 按钮获取仓库的 URL，接着在终端输入以下命令将仓库克隆到本地：

git clone https://github.com/username/repository.git

这将创建一个本地仓库副本，你可以开始进行修改。

3. 基本Git操作与分支管理

3.1 添加文件到暂存区（git add）

当你修改文件后，Git 不会自动将更改加入版本控制，需使用 git add 命令来将更改添加到暂存区：

git add .

这个命令将所有修改过的文件添加到暂存区。

3.2 提交更改（git commit）

提交操作将暂存区的更改保存到本地仓库：

git commit -m "提交说明"

-m 后面是你对该次提交的简短说明。

3.3 推送更改到远程仓库（git push）

将本地仓库的提交推送到 GitHub 仓库：

git push origin main

这将会把你的更改上传到远程仓库的 main 分支。

3.4 从远程仓库拉取最新更改（git pull）

当其他人也在同一个仓库中做了更改时，你需要使用 git pull 拉取最新的更改：

git pull origin main
3.5 创建分支（git branch）

分支用于开发新特性或修复 bug，而不影响主代码。你可以使用以下命令创建一个新分支：

git branch new-branch
3.6 切换分支（git checkout）

切换到你要操作的分支：

git checkout new-branch
3.7 合并分支（git merge）

合并其他分支的更改到当前分支：

git merge new-branch
3.8 解决冲突

当多个分支修改同一部分内容时，可能会发生冲突。Git 会标记出冲突的部分，你需要手动解决并重新提交。

4. 提交和管理 Issue

在 GitHub 上，Issue 是用于记录、讨论和跟踪任务、bug 或功能请求的重要工具。无论是个人项目还是团队协作，管理 Issue 是确保开发进度和问题解决的关键。

4.1 创建一个 Issue

Issue 是管理项目中待办事项的常用方法。你可以在 GitHub 上创建 Issue 来记录任务、bug、功能请求或其他需要讨论的问题。

  1. 进入你的仓库：打开 GitHub，进入你要提交 Issue 的项目仓库。
  2. 点击 “Issues” 标签：在仓库页面上方的导航栏中找到并点击 Issues。
  3. 点击 “New issue”：在 Issue 页面，点击右侧的 New issue 按钮，开始创建新问题。
  4. 填写标题和描述：
    • 标题：简洁明了地描述问题或任务。
    • 描述：详细描述问题的背景、重现步骤、预期行为、实际行为等。你可以使用 GitHub 的 Markdown 语法格式化文本，使内容更易读。
    • 可选：你可以附上截图或日志，帮助更好地理解问题。
  5. 点击 “Submit new issue”：填写完成后，点击 Submit new issue 提交。
4.2 使用标签、分配人员和项目板管理 Issue

管理 Issue 时，使用标签、分配人员和项目板可以帮助团队有效地组织和跟踪问题的进展。

  • 标签 (Labels)：

    • 标签是 Issue 的分类标识，可以让你快速识别问题的类型或优先级。例如：
      • bug：表示一个错误或问题。
      • enhancement：表示一个功能增强或优化请求。
      • help wanted：表示需要帮助的任务。
      • good first issue：适合新手开发者的任务。
    • 要为 Issue 添加标签，进入 Issue 页面，右侧会有一个标签管理区域，点击标签进行选择。

  • 分配人员 (Assignees)：

    • 你可以将 Issue 分配给仓库中的某个成员，指派他们处理该任务。分配人员通常是负责修复 bug 或完成任务的开发者。
    • 在 Issue 页面右侧的 Assignees 区域，点击 Assign yourself（分配给自己）或者选择其他团队成员进行分配。

  • 项目板 (Projects)：

    • 使用项目板可以将 Issue 按照任务或功能区分到不同的项目板，以便更好地跟踪任务的进展。
    • 点击 Issue 页面右侧的 Projects，选择一个已有的项目板或者创建一个新的项目板。
    • 项目板通常按 To do、In progress、Done 等不同阶段分组，方便开发团队集中管理。

  • 里程碑 (Milestones)：

    • 如果你有多个 Issue 与某个特定版本或阶段相关，可以为它们设置 里程碑。这有助于追踪项目进度并确保按时交付。
    • 在 Issue 页面右侧的 Milestone 区域，选择或创建一个适合的里程碑。
4.3 关闭和跟进 Issue

随着项目的进展，Issue 会被解决或关闭。在 GitHub 中，有几种方法可以管理和跟进 Issue。

  • 关闭 Issue：

    • 当 Issue 被解决或任务完成时，点击 Issue 页面右上角的 Close issue 按钮来关闭它。关闭后的 Issue 不会再出现在待办事项中。
    • 如果你解决了一个 bug 或实现了一个功能，也可以在提交 Pull Request 时自动关闭相关的 Issue（例如，在提交信息中添加 Fixes #issue_number）。

  • 重新打开 Issue：

    • 如果问题没有得到解决，或者 Issue 被关闭后仍然存在问题，可以随时重新打开它。点击关闭的 Issue 页面中的 Reopen issue 按钮，将其恢复为活动状态。

  • 评论和更新 Issue：

    • 在 Issue 页面，你可以随时发表评论，更新任务进度或讨论问题。如果你是 Issue 的创建者或者已被分配的开发者，可以在评论区回复其他开发者的反馈或提出自己的意见。
    • 评论是团队沟通的关键，保持良好的沟通可以加速问题解决。

  • 关联其他 Issue 或 Pull Request：

    • 如果一个 Issue 与另一个 Issue 或 Pull Request 相关联，你可以在描述或评论中使用 #issue_number 来引用它。这能帮助团队成员快速了解任务之间的关系。

  • 订阅 Issue 更新：

    • 如果你希望跟进某个 Issue 的进展，可以选择订阅它。在 Issue 页面右上角点击 Subscribe，这样每当 Issue 状态发生变化时，你将收到通知。

通过这些功能，你可以有效管理 GitHub 上的 Issue，确保项目按时完成，协作更加顺畅。

5. 提交 Pull Request (PR)

Pull Request (PR) 是 GitHub 上协作开发的核心机制，它允许开发者将自己的代码更改提交给主仓库进行审查和合并。通过 PR，其他开发者能够查看你的更改，提供反馈，并确保代码质量符合项目要求。

5.1 什么是 Pull Request？

Pull Request 是一种请求，旨在让你所做的更改被其他开发者审查、讨论，并最终合并到主分支（通常是 main 或 master）。PR 是团队协作的核心，通过它，开发者可以集中管理和审查代码，确保质量和功能符合需求。

简单来说，PR 就像是向团队提出的“代码合并申请”，提交后其他人可以审查、评论或提出修改建议，直到代码准备好被合并到主分支。

5.2 创建一个 Pull Request

创建一个 PR 的过程非常简单，它有助于将你的更改提到团队面前进行审查。以下是创建 PR 的步骤：

  1. 切换到你所做更改的分支：

    • 在本地仓库中，你可能已经在一个新的分支上做了更改（通常从 main 或 master 分支派生）。
    • 确保你的更改已经推送到 GitHub 上的相应分支。

  2. 点击 “Compare & pull request”：

    • 在 GitHub 上的仓库页面中，切换到你所做更改的分支。
    • GitHub 通常会在你切换到分支后显示一个按钮：“Compare & pull request”。点击这个按钮进入 PR 创建页面。

  3. 填写标题和描述：

    • 标题：简洁明了地说明 PR 的目的，例如 “Fix bug in login page” 或 “Add new feature for user profile”。
    • 描述：详细说明你所做的更改，包括哪些文件被修改、修复了什么问题、添加了哪些新功能等。你可以提供额外的背景信息，帮助审查者理解你的更改。
    • 在描述中，如果有需要，可以引用相关的 Issue（例如：Closes #45，意味着合并该 PR 后将自动关闭 Issue #45）。

  4. 点击 “Create pull request”：

    • 完成标题和描述后，点击页面底部的 Create pull request 按钮提交你的 PR。

现在，你的更改已经作为一个 PR 提交给项目维护者进行审查了。

5.3 代码审查与合并 Pull Request

提交 PR 后，团队成员或项目维护者将会进行代码审查。他们会查看你的代码更改，提出建议或修复意见，并检查代码是否符合项目规范和质量要求。代码审查的过程通常包括以下几个步骤：

  1. 查看代码：

    • 审查者会查看你提交的代码，检查其正确性、效率、可维护性等方面。
    • 他们可能会检查你是否遵循了项目的编码规范，是否有冗余的代码或潜在的 bug。

  2. 提出反馈：

    • 如果审查者发现问题，他们会在 PR 的评论区域提出反馈，可能是代码风格问题、逻辑错误，或者是一些优化建议。
    • 你可以在评论中与审查者讨论解决方案，修改你的代码并更新 PR。

  3. 修复反馈问题：

    • 如果审查者要求你修改代码，你可以在本地做出更改并推送到远程分支。GitHub 会自动将这些新更改添加到已有的 PR 中。
    • 一旦修改完成，再次提交 PR，审查者会重新审查这些更改。

  4. 合并 PR：

    • 当所有问题都解决且代码审查通过时，项目维护者会将 PR 合并到主分支中。通常会使用 Merge pull request 按钮。
    • 合并操作后，PR 会关闭，并且更改会被应用到主分支。这个过程中，通常会执行 Merge commit 或 Squash and merge，取决于项目的 Git 流程。
5.4 使用 Draft PRs 和 变更请求

GitHub 提供了 Draft PRs 和 变更请求 (Change requests) 功能，使得代码审查和协作更加灵活。

  • Draft PRs：

    • 如果你的代码还在进行中，或者你想要早期获取团队反馈，但尚未准备好正式合并，可以选择创建一个 Draft PR。Draft PR 是一种“草稿”状态，意味着代码审查人员不会立即合并该 PR。
    • 创建时，你可以在 PR 页面中选择 Create draft pull request。这使得审查者可以提前看到代码并提供反馈，但该 PR 不会立即合并。

  • 变更请求 (Change Requests)：

    • 当审查者对 PR 提出了修改建议并要求做出改动时，GitHub 会将该审查标记为“变更请求”。这意味着你需要对代码做出更改并推送到原来的分支。
    • 你可以在 PR 页面右侧看到变更请求的具体内容。完成修改后，提交新的代码更改，审查者会重新查看。

使用 Draft PR 和变更请求功能，团队可以更早地开始讨论代码，更灵活地管理审查和合并流程。

6. 管理你的仓库

在 GitHub 上管理仓库的设置和权限非常重要，尤其是当你与团队合作时。通过设置，你可以自定义仓库的各项功能并确保数据的安全性。

  1. 仓库设置：

    • 进入仓库页面，点击右上角的 Settings 标签，进入仓库的设置页面。这里你可以配置许多选项，比如：
      • Repository name：修改仓库名称。
      • Description：修改仓库的简短描述。
      • Default branch：设置默认分支（通常为 main 或 master）。
      • GitHub Pages：如果你的项目是网站，可以启用 GitHub Pages 部署功能。
      • Webhooks：配置 Webhooks，用于在仓库发生事件（如推送、PR 合并）时触发外部应用程序或服务。

  2. 权限管理：

    • 协作者：你可以邀请其他开发者加入你的仓库，成为协作者，使他们能够访问和修改仓库内容。协作者可以拥有不同的权限等级：
      • Read：只读权限，允许查看仓库的内容，但不能推送更改。
      • Write：写权限，允许对仓库进行推送和修改。
      • Admin：管理员权限，允许管理仓库的所有设置，包括添加或移除协作者、删除仓库等。
    • 要邀请协作者，进入仓库的 Settings 页，选择 Manage access，然后点击 Invite a collaborator，输入他们的 GitHub 用户名并选择合适的权限。

  3. 分支保护：

    • 通过仓库设置，你还可以启用 Branch protection rules，确保主分支（或其他重要分支）不会被直接推送或破坏。你可以设置强制代码审查，要求在合并 PR 前至少有一个审核者批准，或者禁止直接推送到保护的分支。

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.rhkb.cn/news/472462.html

如若内容造成侵权/违法违规/事实不符，请联系长河编程网进行投诉反馈email:809451989@qq.com，一经查实，立即删除！

相关文章

C++- 基于多设计模式下的同步异步日志系统

C++- 基于多设计模式下的同步异步日志系统

第一个项目：13万字，带源代码和详细步骤 目录 第一个项目：13万字，带源代码和详细步骤 1. 项目介绍 2. 核心技术 3. 日志系统介绍 3.1 为什么需要⽇志系统 3.2 ⽇志系统技术实现 3.2.1 同步写⽇志 3.2.2 异步写⽇志 4.知识点和单词补充 4.1单词补充 4.2知识点补充…
阅读更多...
Node.js GET/POST请求、WEB模块使用介绍 （基础介绍 八）

Node.js GET/POST请求、WEB模块使用介绍 （基础介绍 八）

GET/POST请求 在很多场景中，我们的服务器都需要跟用户的浏览器打交道，如表单提交。 表单提交到服务器一般都使用 GET/POST 请求。 本章节我们将为大家介绍 Node.js GET/POST请求。 获取GET请求内容 由于GET请求直接被嵌入在路径中，URL是…
阅读更多...
字节青训-小M的多任务下载器挑战、版本号比较

字节青训-小M的多任务下载器挑战、版本号比较

目录 一、小M的多任务下载器挑战 题目背景 题目内容 数据输入 数据输出 数据与约定 示例1 示例2 解题思路： 问题理解 数据结构选择 算法步骤 最终代码： 运行结果： 二、版本号比较 问题描述 样例 示例 1: 示例 2: 示例 3:…
阅读更多...
jenkins用户在执行scp的时候如何做免密登录

jenkins用户在执行scp的时候如何做免密登录

一、背景 在jenkins job中执行scp的shell命令，当然不希望每次输入密码，另外处于出于安全考虑，也不建议在scp命令中指定。 所以，我们需要对远程机器进行免密登录。 本文遇到的问题是，在jenkins机器上执行scp已做到了…
阅读更多...
Prometheus监控SQL SERVER常用指标和PromQL预警

Prometheus监控SQL SERVER常用指标和PromQL预警

SQL Server是企业级广泛应用的数据库，通过简单的Prometheus exportor可以很容易地监控它。与所有数据库一样，SQL Server也有许多故障点，例如事务延迟或数据库中连接过多。本文介绍如何使用Prometheus监视SQL Server，包括常用的监控…
阅读更多...
HTML5实现俄罗斯方块小游戏

HTML5实现俄罗斯方块小游戏

文章目录 1.设计来源1.1 主界面1.2 皮肤风格1.2 游戏中界面1.3 游戏结束界面 2.效果和源码2.1 动态效果2.2 源代码 源码下载 作者：xcLeigh 文章地址：https://blog.csdn.net/weixin_43151418/article/details/143788449 HTML5实现俄罗斯方块小游戏&#x…
阅读更多...
从北美火到中国，大数据洞察品牌“STANLEY”的突围之路

从北美火到中国，大数据洞察品牌“STANLEY”的突围之路

保守直筒大头的“硬汉”外形，以百变颜色踩中时尚命脉，与各路大牌“梦幻联动”，不少时尚弄潮儿没能逃过其“真香”诱惑。 这就是今年以来从北美火到中国的STANLEY，在“巨无霸”水杯中突围出属于自己的一条路。 最近STANLEY又整活…
阅读更多...
linux逻辑卷练习

linux逻辑卷练习

目录 知识点： 常用命令 题目： 解题： 1）分区 2）创建物理卷 3）创建卷组 4）生成逻辑卷 "要带参数 -n" 5）扩容 6）格式化(添加文件系统) 7）挂…
阅读更多...
java版嘎嘎快充汽车单车充电系统源码系统jeecgboot

java版嘎嘎快充汽车单车充电系统源码系统jeecgboot

汽车使用云快充1.6 1.5协议，单车用的铁塔协议 前端uniapp、后端jeecgbootvue2
阅读更多...
【Vitepress报错】Error: [vitepress] 8 dead link(s) found.

【Vitepress报错】Error: [vitepress] 8 dead link(s) found.

原因 VitePress 在编译时，发现 死链接(dead links) 会构建失败！具体在哪我也找不到… 解决方案 如图第一行蓝色提示信息，设置 Vitepress 属性 ignoredeadlinks 为 true 可忽略报错。 .vuepress/config.js export default defineConfig(…
阅读更多...
《Django 5 By Example》阅读笔记：p105-p164

《Django 5 By Example》阅读笔记：p105-p164

《Django 5 By Example》学习第5天，p105-p164总结，总计60页。 一、技术总结 1.文章标签功能 Django自带django-taggit。 2.自定义template tags 3.roadmap功能 4.RSS功能 5.full-text搜索功能 这里使用的是Postgresql,使用pip install psycopg安…
阅读更多...
awk（常用）

awk（常用）

这个有点难 O.o 一、awk # 语法 awk 参数 模式 {动作} 文件# 第一列，包含p的 $1~"p" # 第一列，不包含p的 $1!~"p" # 开始时干嘛，结束时干嘛 awk BEGIN{开始时做的事}END{结束时做的事}{print $0} 文件 1、内置变量&…
阅读更多...
数据结构—栈和队列

数据结构—栈和队列

目录 1.栈底层结构的选择 2.栈的实现 3.栈 3.1入栈 3.2出栈 3.3栈顶删除 4.队列 4.1队列介绍 4.2队列初始化 4.3入队列 4.4队头删除 1.栈底层结构的选择 栈是一种数据结构 具有“后进先出的”的特点 现在面临的两种选择，一种是顺序表，另一种…
阅读更多...
安装paddle

安装paddle

网址：飞桨PaddlePaddle-源于产业实践的开源深度学习平台 或者找对应python和cuda版本的paddle下载后安装： https://www.paddlepaddle.org.cn/whl/linux/mkl/avx/stable.html 你想要安装paddlepaddle - gpu2.6.1.post112版本。在你提供的文件列表中&am…
阅读更多...
【解决】Layout 下创建槽位后，执行 Image 同步槽位位置后表现错误的问题。

【解决】Layout 下创建槽位后，执行 Image 同步槽位位置后表现错误的问题。

开发平台：Unity 6.0 编程语言：CSharp 编程平台：Visual Studio 2022   一、问题背景 | 开发库存系统 图1 位置同步失败问题 图2 位置正常同步效果表现 黑框 作用于 UnityEngine.UI.GridLayoutGruop，形成 4x6 布局，如…
阅读更多...
电商系统开发：Spring Boot框架实战

电商系统开发：Spring Boot框架实战

3 系统分析 当用户确定开发一款程序时，是需要遵循下面的顺序进行工作，概括为：系统分析–>系统设计–>系统开发–>系统测试，无论这个过程是否有变更或者迭代，都是按照这样的顺序开展工作的。系统分析就是分析系…
阅读更多...
Spring Boot3 实战案例合集上线了

Spring Boot3 实战案例合集上线了

Spring Boot3实战案例合集
阅读更多...
深度神经网络DNN反向传播BP算法公式推导

深度神经网络DNN反向传播BP算法公式推导

深度神经网络DNN反向传播BP算法推导、δ法则 文章目录 前言一、单个神经元的内部结构二、前向传播三、反向传播总结 前言 \;\;\;\;\; 本文详细推导深度神经网络DNN反向传播BP算法中对权重w和偏置b的更新公式。通过图片和一步步的数学公式推导深刻理解反向传播BP算法&#xff0c…
阅读更多...
借助Excel实现Word表格快速排序

借助Excel实现Word表格快速排序

实例需求：Word中的表格如下图所示，为了强化记忆，希望能够将表格内容随机排序，表格第一列仍然按照顺序编号，即编号不跟随表格行内容调整。 乱序之后的效果如下图所示（每次运行代码的结果都不一定相同&#x…
阅读更多...
HarmonyOS 开发环境搭建

HarmonyOS 开发环境搭建

HarmonyOS（鸿蒙操作系统）作为一种面向全场景多设备的智能操作系统，正逐渐在市场上崭露头角。为了进入HarmonyOS生态，开发者需要搭建一个高效的开发环境。本文将详细介绍如何搭建HarmonyOS开发环境，特别是如何安装和配置…
阅读更多...
最新文章
推荐文章

Copyright @ 2022~2023