# 开放原子开源社团-从 Hello Git 到开源同行

**Repository Path**: srgxt/jmiopenatom-demo1

## Basic Information

- **Project Name**: 开放原子开源社团-从 Hello Git 到开源同行
- **Description**: 在代码协作与项目迭代的过程中，Git 不仅是开发者的基础工具，更是连接个体创新与开源生态的关键纽带。就推动软件强国建设、助力科技自立自强的时代需求而言，掌握 Git 是开启开源世界大门、汇聚全球技术协作力量的重要起点。本次活动聚焦零基础与入门群体，通过专业且易于理解的讲解以及沉浸式实操，助力参与者轻松掌握这一开源核心工具，为其后续深入钻研技术领域、贡献开源力量奠定坚实基础。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 17
- **Forks**: 103
- **Created**: 2025-10-24
- **Last Updated**: 2025-12-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🚩 同学看过来！Git 实操活动说明 - 任务文档

## 前置条件

1. 已注册并拥有 **Gitee 账号**（若未注册，可先访问 [G](https://gitee.com/)[ite](https://gitee.com/)[e 官](https://gitee.com/)[网](https://gitee.com/) 完成注册）

2. 本地计算机已成功安装 Git（安装教程见下文第二步 “克隆到本地” 环节）

## 一、活动简介

Git 是现代开发者的核心必备技能，不仅是高效的代码管理工具，更是连接个人创新与开源协作的关键桥梁。本次活动专为零基础同学设计，通过 **“图文分步讲解 + 手把手实操演练”** 的形式，帮助大家快速掌握 Git 基础操作与开源项目协作流程，为后续技术学习、项目开发及开源贡献筑牢基础。

---

## 二、活动流程（分步实操）

### 第一步：Fork 官方仓库（获取个人副本）

Fork 的核心作用是：从官方仓库复制一份独立副本到自己的 Gitee 账户，后续可在个人副本中自由修改代码，最终通过 PR（Pull Request）将成果贡献回原仓库。

操作步骤：

1. 打开本次活动的 **官方仓库页面**（即当前查看的仓库），点击页面右上角的 **「Fork」** 按钮。

2. 在弹出的窗口中，确认 “目标仓库” 为自己的 Gitee 个人空间，点击「确认」完成 Fork。

3. 等待几秒后，刷新页面，若仓库地址显示为「你的 Gitee 用户名 / 仓库名」，则代表 Fork 成功，该仓库会自动出现在你的 Gitee 主页 “我的仓库” 列表中。

> 💡 小贴士：Fork 后的仓库是独立的，修改个人副本不会影响官方仓库，后续仅需通过 PR 即可将你的代码同步到官方仓库。

![fork1](/images/fork1.png)

![fork2](/images/fork2.png)

![fork3](/images/fork3.png)

---

### 第二步：克隆仓库到本地（将代码下载到电脑）

#### 前置准备：安装 Git

若本地未安装 Git，请先观看安装教程完成安装：[Git](https://www.bilibili.com/video/BV1Hkr7YYEh8)[ 安装教程](https://www.bilibili.com/video/BV1Hkr7YYEh8)[（B 站）](https://www.bilibili.com/video/BV1Hkr7YYEh8)（建议选择与自己电脑系统（Windows/macOS）匹配的安装步骤）。

#### 克隆操作步骤：

1. 进入你已 Fork 成功的 **个人仓库页面**，点击页面上方的 **「克隆 / 下载」** 按钮，在弹出的菜单中选择「HTTPS」，点击右侧的「复制图标」，复制仓库的 HTTPS 地址（格式类似：` https://gitee.com/你的用户名/仓库名.git `）。

![clone1](/images/clone1.png)

![clone2](/images/clone2.png)

1. 在本地电脑中，选择一个**空文件夹**（建议选择路径简单、无中文 / 特殊符号的文件夹，如 `D:\GitProjects`），右键点击文件夹空白处，选择 **“在终端中打开”**（Windows 系统若未显示该选项，可先打开「命令提示符」或「PowerShell」，通过 `cd 文件夹路径` 命令进入目标文件夹）。

![clone3](/images/clone3.png)

1. 在终端中，输入以下命令，将刚刚复制的仓库地址粘贴到 `<你的仓库地址>` 位置（注意命令中 “clone” 后有空格）：

```
git clone <你的仓库地址>
```

示例：` git clone https://gitee.com/hezhihao/jmiopenatom-demo1.git`

![clone4](/images/clone4.png)

1. 按下回车键，等待代码下载完成。若终端最后一行显示 **“done”** 或 “成功克隆到「仓库名」”，则代表克隆成功，此时目标文件夹中会新增一个与仓库名一致的子文件夹（如 `jmiopenatom-demo1`），代码已保存到本地。

![clone5](/images/clone5.png)

1. 打开克隆成功的 `jmiopenatom-demo1` 文件夹，进入其下的 `src` 子文件夹，在 `src` 文件夹中**新建一个个人专属文件夹**，命名必须严格遵循以下格式：

```
班级-姓名-学号

示例：软件技术252301-何治皓-2521412301
```

> ⚠️ 重要提醒：文件夹命名格式错误会直接导致后续 PR 审核不通过，无法完成活动！请务必核对班级、姓名、学号的准确性，且名称中无空格、特殊符号。

![clone6](/images/clone6.png)

1. 进入你新建的个人专属文件夹（如 `软件技术252301-何治皓-2521412301`），在此文件夹内完成你的代码编写（可创建各类代码文件，如 `.java`、`.py`、`.html` 等，内容不限，建议选择自己熟悉或感兴趣的项目方向）。

---

### 第三步：编写个人代码（核心任务）

在你的个人专属文件夹内，完成代码编写（可是一个简单的小项目，如计算器、个人介绍页面、小游戏等）。

> ⚠️ 三次重点提醒：

1. 请务必先完成代码编写，确保个人文件夹内有完整的代码文件后，再进行第四步操作，否则会导致 PR 审核不通过，无法完成活动！

2. 代码文件需直接放在个人专属文件夹下，不建议嵌套多层子文件夹（便于管理员审核）。

3. 请确保代码可正常运行（若有依赖包，可在文件夹内新建 `README.md` 文件说明依赖安装方式），无语法错误。

---

### 第四步：提交代码并推送到 Gitee（将本地代码同步到云端）

#### 操作前提：

已完成个人代码编写，且当前处于 `jmiopenatom-demo1` 文件夹（即项目根目录）下。

#### 步骤：

1. 右键点击 `jmiopenatom-demo1` 文件夹空白处，选择 **“在终端中打开”**。

2. 在终端中，**一行一行复制执行以下命令**（每执行完一条命令，确认无报错后再执行下一条）：

- 第一条命令：将本地修改的文件添加到 Git 暂存区（`.` 代表添加当前目录下所有修改的文件）

```
git add .
```

- 第二条命令：提交暂存区的文件到本地 Git 仓库，并添加提交说明（将 `"这是一次提交"` 替换为更具体的说明，如 `"提交个人代码：简单计算器项目"`，便于后续追溯）

```
git commit -m "提交个人代码：\[你的项目名称]"
```

- 第三条命令：将本地提交的代码推送到你的 Gitee 个人仓库（`origin` 代表远程仓库地址，`master` 是分支名称，若你的仓库默认分支是 `main`，则将 `master` 改为 `main`）

```
git push origin master
```

1. **首次推送验证**：若为首次向 Gitee 推送代码，终端会弹出窗口或提示输入 Gitee 账号和密码（部分版本可能要求输入 “用户名” 和 “个人访问令牌”，而非密码）：

![push1](/images/push1.png)

![push4](/images/push4.png)

- 若提示输入 “个人访问令牌”：需先在 Gitee 中创建令牌（路径：Gitee 主页 → 右上角头像 → 「设置」→ 「安全设置」→ 「个人访问令牌」→ 「生成新令牌」，勾选 “repo” 相关权限，生成后复制令牌，粘贴到终端密码输入处）。

- 输入完成后，按下回车键，若终端最后一行显示 **“done”** 或 “100%”，则代表推送成功，此时你的 Gitee 个人仓库会同步显示本地编写的代码。

> 💡 小贴士：若推送时出现 “branch master does not exist” 报错，可能是你的仓库默认分支为
>
> `main`
>
> ，将第三条命令改为
>
> `git push origin main`
>
> 即可。

---

### 第五步：提交 Pull Request（PR）（申请将代码合并到官方仓库）

PR 的作用是：向官方仓库管理员发起申请，请求将你个人仓库中的代码合并到官方仓库，审核通过后，你的代码就会成为官方仓库的一部分。

#### 步骤：

1. 打开你的 Gitee 个人仓库页面（已完成代码推送的仓库），点击页面上方的 **「Pull Request」** 按钮（部分版本显示为「发起 Pull Request」）。

![pr1](/images/pr1.png)

![pr2](/images/pr2.png)

1. 在 PR 编辑页面，**重点确认两个红框内容是否正确**：

![pr3](/images/pr3.png)

- 左侧 “源仓库”：需显示为「你的 Gitee 用户名 / 仓库名」，分支为 `master`（或 `main`，与你推送的分支一致）。

- 右侧 “目标仓库”：需显示为官方仓库（如「组织名 / 仓库名」），分支为 `master`（或官方指定的目标分支）。

  若两者不一致，点击下拉框修改，确保匹配后再进行下一步。

1. 在 “标题” 和 “描述” 文本框中填写内容：

![pr4](/images/pr4.png)

- 标题：简洁说明 PR 内容，如「\[软件技术 252301 - 何治皓] 提交个人计算器项目代码」。

- 描述：可补充项目细节（如 “项目功能：实现加减乘除运算”）或简单的自我介绍（如 “大家好，我是软件技术 252301 班的何治皓，本次提交的是 Java 编写的计算器项目”），便于管理员快速了解你的代码。

1. 确认所有信息无误后，点击页面下方的 **「创建」** 按钮，完成 PR 提交。

2. 提交后，等待官方管理员审核（审核结果会通过 Gitee 站内信通知你，也可在 PR 页面查看审核进度）。

#### 审核通过提示：

若 PR 审核通过，你会收到 Gitee 站内信通知，同时 PR 页面会显示 “已合并”。后续 Pu 分将根据你的 PR 代码发放，具体发放时间请关注 QQ 群通知。

![pr7](/images/pr7.png)

> ⚠️ 若 PR 审核未通过：请查看管理员的审核备注（如 “文件夹命名错误”“代码缺失”），根据提示修改后，重新执行 “第四步（提交推送）” 和 “第五步（提交 PR）” 即可。

---

## 三、活动完成标准

当你的 PR 状态显示为 **“已合并”**（即官方仓库已接收你的代码），即代表本次 Git 实操活动完成。

---

## 四、帮助与资源

若在操作过程中遇到问题，可通过以下方式获取帮助：

1. **视频教程**：[Git 实](https://b23.tv/e963L5z)[操完整教程](https://b23.tv/e963L5z)[（B 站）](https://b23.tv/e963L5z)（若文档步骤看不懂，可观看视频跟着操作）

2. **Git 官方文档**：[Git](https://git-scm.com/book/zh/v2)[ 官网（含](https://git-scm.com/book/zh/v2)[中文教程）](https://git-scm.com/book/zh/v2)（可查询 Git 命令的详细用法）

3. **常见问题排查**：

- 克隆失败：检查仓库地址是否复制正确、网络是否正常、本地文件夹是否为空。

- 推送失败：检查账号密码 / 个人访问令牌是否正确、分支名称是否匹配（master/main）。

- PR 无法创建：检查源仓库和目标仓库是否选择正确、是否已完成代码推送。

---

**文档编写**：

软件技术 252301 - 何治皓

软件技术 252301 - 李淑婕

**视频教程制作**：

鸿蒙菁英 241301 - 范德鑫

**文档更新时间**：2025 年 10 月 26 日

> （注：文档部分内容由 AI 生成）