主流源代码管理工具的介绍——以github为例

从Git到GitHub：软件项目开发的源代码管理全指南

引言

在本学期的软件开发与创新课程中，我所在的小组负责开发一款名为校易通的校园二手交易平台，包含商品展示、闲置发布、私信沟通、个人中心等完整功能模块。但是开发过程中很多时候我们做的修改会很混乱，有的bug修好了但是另一个人在修其他bug的时候没同步，导致另一个bug修完了，前一个bug又出现了，导致前功尽弃，相信这也是很多学生开发小组会遇到的问题。这时候就需要使用源代码管理工具。

在项目启动初期，我们遇到了一个几乎所有学生团队都会踩的坑：很多同学以为直接打开GitHub网页就能管理团队代码。结果就是有人直接在网页上上传文件，有人改了代码不知道怎么同步，最后代码版本混乱，多人修改互相覆盖，项目进度严重受阻。

直到我们搞清楚一个最核心的事实：想要正常使用GitHub，必须先在本地安装并配置Git。Git是本地版本控制的基石，GitHub是基于Git的云端协作平台，二者缺一不可。

这篇博客就以我们的校园二手交易平台开发实战为例，从零开始讲解Git与GitHub的完整使用流程，帮你彻底掌握团队项目的源代码管理规范。

一、Git 和 Github：Git ≠ GitHub，他们是地基与大楼的关系

作为初学者，我一开始把Git和GitHub混为一谈，其实它们的定位和作用完全不同，是本地工具和云端服务的互补关系：

工具 本质 核心作用 在校园二手交易平台中的具体应用
Git 本地分布式版本控制系统 记录代码修改、管理版本历史、创建独立分支、本地提交代码 安装在每个人的电脑上，管理自己写的代码文件，记录每一次修改
GitHub 远程代码托管与团队协作平台 云端存储代码、多人共享同步、代码评审合并、任务BUG管理 作为团队的中央仓库，存储整个项目的代码，实现多人团队的协同开发

一句话总结：

  • 没有Git，GitHub就是一个空壳，无法接收、同步、管理任何代码；
  • 没有GitHub，Git只能在本地单机使用，无法实现多人协作和代码备份。

可以配合这张图片食用理解：
image

二、前置必备：Git安装与完整配置

这是使用GitHub的绝对前提，没有这一步，后面所有操作都无法进行。

1. Git下载与安装

Git是完全免费的开源工具，直接从官网下载对应系统版本即可：

  • 官网地址：https://git-scm.com/downloads
  • Windows系统：下载exe安装包，一路默认下一步，安装完成后右键会出现Git Bash Here选项
  • Mac系统：通过Homebrew安装 brew install git
  • Linux系统：命令行直接安装 sudo apt install git
    image

验证安装是否成功

安装完成后，在任意位置右键打开Git Bash，输入以下命令：

git --version

如果显示类似git version 2.45.1的版本号，说明安装成功。

2. Git全局身份配置

Git需要绑定你的GitHub身份，才能将本地提交关联到你的账号，一台电脑只需要配置一次：

# 配置你的GitHub用户名（与注册时一致）
git config --global user.name "你的GitHub昵称"

# 配置你的GitHub注册邮箱
git config --global user.email "你的GitHub邮箱地址"

验证配置是否生效

git config --global --list

显示刚才输入的用户名和邮箱，即配置完成。

3. 配置SSH密钥（免密码推送）

为了避免每次上传代码都输入账号密码，我们配置SSH密钥实现本地与GitHub的安全连接：

  1. 在Git Bash中输入命令生成密钥对：
    ssh-keygen -t rsa -C "你的GitHub邮箱地址"
  2. 连续按3次回车，使用默认路径和空密码；
  3. 找到生成的公钥文件：
    • Windows：C:\Users\你的用户名\.ssh\id_rsa.pub
    • Mac/Linux：~/.ssh/id_rsa.pub
  4. 用记事本打开公钥文件，复制里面的全部内容；
  5. 打开GitHub → 右上角头像 → Settings → SSH and GPG keys → New SSH key；
  6. 粘贴公钥内容，点击保存。

这个我是从CSDN教程上找到的资料，简单易懂可以参考：
image

配置完成后，本地Git就可以无缝连接GitHub了。

image

三、GitHub核心功能：校园二手交易平台实战应用

配置好Git后，GitHub才能真正发挥团队协作的价值。以我们的项目为例，GitHub承担了以下核心功能：
image

1. 仓库（Repository）：我认为这就相当于项目代码的云端之家

我们为校园二手交易平台创建了专属公共仓库campus-second-hand-platform，存储所有代码和文档：

  • 代码文件：index.html、style.css、script.js
  • 项目文档：README.md（项目介绍、技术栈、运行说明）
  • 配置文件：.gitignore（过滤不需要提交的文件，如IDE配置、临时文件）

2. 分支（Branch）：我认为这个也极其重要，很人性化

这是Git最核心的优势之一，通过分支隔离，每个人可以独立开发自己的模块，不会影响主代码：
分支可以被理解为代码的平行宇宙，在这个独立的环境中，开发者可以自由地开发新功能或修复问题，而不会干扰到主分支。在多人协作的项目中，每个开发者通常都会在自己的分支上工作，最终再将这些分支合并到主分支上。

这个图片帮助你理解：
image
想要开发新功能模块 像这样创建一个分支feature-A，确认没问题，再合并是不错的选择

  • main：主分支，只保存稳定可运行的代码，禁止直接修改
  • feature/home-page：开发首页Hero区域和精选商品列表
  • feature/publish-module：开发商品发布表单和图片上传功能
  • feature/chat-system：开发私信沟通模块
  • bugfix/price-display：修复商品价格显示异常的BUG

image

3. 提交（Commit）：代码修改的完整记录

每一次有意义的代码修改，都应该通过Git提交，并附上清晰的说明，相关git命令如下：

# 添加所有修改的文件到暂存区
git add .

# 提交代码，遵循统一的提交信息规范
git commit -m "feat: 完成商品收藏功能及本地存储逻辑"

命令如果觉得不好记，当然也可以直接在编辑器用可视化界面操作git
最好能像下面根据需要设置好规范，增加可读性，这样不会那么乱

团队统一提交信息规范：

  • feat: 新增功能
  • bugfix: 修复BUG
  • docs: 修改文档
  • style: 调整样式
  • refactor: 代码重构

4. Pull Request（PR）：代码评审与合并

开发完成后，不能直接合并到主分支，必须通过PR流程进行代码评审：

  1. 开发者将本地分支推送到GitHub；
  2. 在GitHub页面提交PR，说明开发的功能和修改点；
  3. 其他团队成员评审代码，提出修改建议；
  4. 开发者根据建议修改后，重新推送代码；
  5. 评审通过后，合并到main主分支。
    操作如下：

image

image

5. Issues：项目任务与BUG管理

我们用Issues管理所有项目任务和问题：

  • 记录BUG："商品详情页图片加载失败"、"私信消息时间显示错误"
  • 分配任务："首页响应式适配" 分配给成员A
  • 跟踪进度：给Issues添加标签（bug、enhancement）和截止时间

四、完整实战流程：Git+GitHub开发校园二手交易平台

我们团队共5人，分工为首页开发、商品发布模块、个人中心模块，以下是我们的标准协作流程：

1. 克隆远程仓库到本地

所有成员在电脑新建项目文件夹，右键打开Git Bash，克隆GitHub上的中央仓库：

# 替换为你的仓库SSH地址
git clone git@github.com:你的用户名/campus-second-hand-platform.git

image

2. 创建并切换到功能分支

每个人基于最新的main分支，创建自己的功能分支：

# 进入项目文件夹
cd campus-second-hand-platform

# 确保本地main分支是最新的
git checkout main
git pull origin main

# 创建并切换到功能分支
git checkout -b feature/你的模块名

3. 本地开发与提交

编写代码完成后，用Git提交本地修改：

# 查看修改状态
git status

# 添加所有修改文件
git add .

# 提交代码
git commit -m "feat: 完成个人中心我的发布列表功能"

4. 推送分支到GitHub

将本地分支推送到云端，让团队其他成员可以看到你的代码：

git push origin feature/你的模块名

5. 提交PR并进行代码评审

  1. 打开GitHub仓库页面，会自动提示"Compare & pull request"；
  2. 填写PR标题和描述，说明开发的功能；
  3. 指定团队成员作为评审人；
  4. 评审通过后，点击"Merge pull request"合并到主分支；
  5. 合并完成后，删除临时功能分支。

6. 同步最新代码

每天开发前，先同步主分支的最新代码，避免产生大量冲突：

git checkout main
git pull origin main

五、Git常用命令速查表

针对一般的开发项目，记住这些命令就足够应对99%的场景：

命令 作用
git clone 仓库地址 克隆远程仓库到本地
git checkout -b 分支名 创建并切换到新分支
git status 查看当前代码修改状态
git add . 添加所有修改文件到暂存区
git commit -m "提交信息" 提交代码到本地仓库
git push origin 分支名 推送本地分支到远程
git pull origin main 拉取主分支最新代码
git log 查看提交历史
git branch 查看所有本地分支

六、学生团队开发避坑指南———给初学者的忠告

结合我们开发校园二手交易平台自己血淋淋的教训，总结了以下最容易踩的坑：

  1. 绝不直接修改main分支：这是最最最重要的，所有开发都必须在功能分支完成，通过PR合并，不然好不容易能运行的代码就被改得找不回来了
  2. 提交信息一定要清晰：不要写"修改代码"、"修复bug"这种模糊描述，别人根本不知道你改了什么
  3. 每天先pull再开发：提前同步最新代码，可以避免90%以上的代码冲突
  4. 不要上传大文件和临时文件：通过.gitignore过滤IDE配置、图片临时文件等

七、总结与感悟

通过这次校园二手交易平台的开发，我深刻体会到了Git+GitHub的强大之处。它们不仅仅是代码管理工具，更是团队协作的规范和标准。
很多同学觉得Git命令复杂难记，但其实对于学生团队项目来说，掌握上面列出的几个核心命令就足够了。更重要的是理解分支开发、代码评审、版本控制这些软件工程的核心思想。

posted @ 2026-05-21 13:56  鱼yuyuyu  阅读(76)  评论(0)    收藏  举报