Git + Gitee 入门讲义
一、Git 核心概念（一张图理解）
┌─────────────────────────────────────────────────────────────────┐
│ Git 工作流程 │
└─────────────────────────────────────────────────────────────────┘
┌──────────────┐ git add ┌──────────────┐
│ 工作区 │ ───────────────→ │ 暂存区 │
│ (Working │ │ (Staging) │
│ Directory) │ │ │
└──────────────┘ └──────┬───────┘
│
│ git commit
▼
┌──────────────┐
│ 本地仓库 │
│(Repository) │
└──────┬───────┘
│
┌──────────────────────────┼──────────────────────────┐
│ │ │
│ git push │ │ git pull
▼ │ ▼
┌────────────────┐ │ ┌────────────────┐
│ Gitee 远程 │←────────────────────────────────→│ Gitee 远程 │
│ 仓库 │ 代码备份/多设备同步 │ 仓库 │
└────────────────┘ └────────────────┘
核心口诀：add → commit → push（保存并上传）
同步口诀：pull → 编辑 → add → commit → push（下载并继续）
二、本地 Git 安装与基础命令
2.1 安装与配置
下载安装git(Git)，配置user.name和user.email
Git - Windows 安装,下载安装包之后，双击即可安装。
# 验证安装
git --version
# 一次性配置（告诉 Git 你是谁）
git config --global user.name "你的名字"
git config --global user.email "你的邮箱@example.com"
这个配置只需要做一次，后续就不用做了。
2.2 项目（仓库）初始化流程
# 1. 进入项目文件夹
cd my-project
# 2. 初始化 Git 仓库
git init # 会创建 .git 隐藏文件夹
# 3. 查看状态（最常用命令）
git status
cd 是进入目录； git init 是初始化仓库； git status 查看状态
2.3 核心命令速查
| 命令 | 作用 | 使用场景 |
|---|---|---|
git add 文件名 | 添加到暂存区 | 修改完文件准备保存 |
git add . | 添加所有修改 | 批量保存 |
git commit -m "描述" | 提交到本地仓库 | 完成一个功能点 |
git restore 文件名 | 撤销工作区修改 | 改错了要回退 |
git log --oneline | 查看提交历史 | 回顾版本 |
三、Gitee 远程仓库操作
3.1 网站独立操作（不依赖本地）
- 注册/登录：gitee.com
- 创建仓库：点击
+→ 新建仓库 → 建议勾选「使用 Readme 初始化」 - 设置 .gitignore：管理 → 仓库设置 → 添加 .gitignore（选择对应语言模板）
- 网页编辑文件：直接点
+→ 新建文件/编辑 → 在线提交
3.2 本地与远程的两种关联方式
方式一：本地已有 → 推送到远程空仓库
# 本地已有项目
cd existing-project
git init
git add . && git commit -m "初始提交"
# 在 Gitee 创建空仓库（不要勾选初始化）
# 然后关联并推送
git remote add origin https://gitee.com/用户名/仓库名.git
git push -u origin master
方式二：远程已有 → 克隆到本地
第一步 建立仓库
登录gitee.com, 点击新建仓库
填写仓库名称（英文名称），项目介绍（可选）
创建成功之后，你就在网络上有一个空间，你可以在线编辑文件，创建新文件，新文件夹，上传文件。类似于网络网盘的效果。
第二步 克隆项目到本地
线上写代码是极少的情况，更普遍的情况是在自己的电脑（本地）上，写代码。
具体操作如下：复制克隆命令。
进入到你自己的电脑的合适的位置，使用cmd窗口，粘贴前面复制的命令，回车运行。
如果你的项目是私有的，这个克隆命令会要求输入用户名和密码。
正确填写之后，点击continue。
此时，你拥有了一份与远程仓库一模一样的代码。
第三步 本地修改代码，并提交到远程仓库
在本地开发项目，例如，新建立一个文件index.html。
如何把这新的文件“同步”到远程仓库？
（1）切换cmd窗口的目录，定位到项目目录中。
（2）三句命令：
git add .
git commit -m "修改说明"
git push
在gitee的仓库中检查一下。
推荐：新手优先用方式二，更简单可靠。
四、实战场景：机房 ↔ 宿舍 两地协作
4.1 场景说明
| 地点 | 特点 | 解决方式 |
|---|---|---|
| 机房 | 电脑重启还原，不能长期存文件 | 下课前 push 到 Gitee |
| 宿舍 | 个人电脑，长期保存 | 用 pull 同步机房进度 |
| Gitee | 代码中转站 | 永不丢失，随时同步 |
4.2 工作流程图
┌─────────────┐ ┌─────────────┐
│ 🏫 机房 │ │ 🏠 宿舍 │
│ │ │ │
│ 下课前必做： │ ┌────────────┐ │ 回宿舍后： │
│ │ │ ☁️ Gitee │ │ │
│ git add . │───→│ 远程仓库 │←────│ git pull │
│ git commit │ │ │ │ │
│ git push │←───│ 代码中转站 │────→│ 继续开发
│ │ └───────────┘ │ git push │
└─────────────┘ └─────────────┘
↑ │
└───────────────────────────────────┘
第二天机房 git pull 继续
4.3 完整操作流程示例
首次在机房开始：
# 1. 克隆仓库（如果已在 Gitee 创建）
git clone https://gitee.com/xxx/my-project.git
cd my-project
# 2. 写代码...
# 3. 下课前必做：保存并上传
git add .
git commit -m "机房：完成登录页面"
git push
回到宿舍继续：
# 1. 进入项目文件夹
cd my-project
# 2. 同步机房最新进度
git pull
# 3. 继续写代码...
# 4. 睡前保存
git add .
git commit -m "宿舍：完成注册功能"
git push
第二天机房继续：
cd my-project
git pull # 获取宿舍写的代码
# 继续开发...
git add . && git commit -m "机房：xxx" && git push
五、常用命令速查表
基础操作
git init # 初始化仓库
git clone <url> # 克隆远程仓库
git status # 查看状态
git add <file> / git add . # 添加到暂存区
git commit -m "描述" # 提交到本地
git commit -am "描述" # 添加并提交（仅限已跟踪文件）
远程操作
git remote -v # 查看远程地址
git remote add origin <url> # 关联远程仓库
git push # 推送到远程
git push -u origin master # 首次推送并关联
git pull # 拉取并合并远程代码
查看与撤销
git log --oneline # 简洁历史
git log --graph # 图形化分支
git restore <file> # 撤销工作区修改
git restore --staged <file> # 取消暂存
六、学习资源
| 资源 | 链接 | 说明 |
|---|---|---|
| Pro Git（中文） | git-scm.com/book/zh/v2 | 官方文档，免费 |
| Learn Git Branching | learngitbranching.js.org/?locale=zh_… | 交互式学习 |
| 廖雪峰 Git 教程 | www.liaoxuefeng.com/wiki/896043… | 国内经典 |
| Gitee 帮助中心 | gitee.com/help | 平台相关 |
七、课堂检查清单
基础掌握
- Git 安装成功并显示版本
- 完成 user.name / user.email 配置
- 能初始化仓库并查看状态
- 掌握 add → commit 完整流程
- 能使用 log 查看历史
远程操作
- 成功注册 Gitee 账号
- 能创建仓库并设置 .gitignore
- 能从 Gitee 克隆仓库
- 能在网页上创建/编辑文件
- 掌握 push 和 pull 的使用
两地协作
- 理解机房 push、宿舍 pull 的工作模式
- 能独立完成：机房 → Gitee → 宿舍 的代码流转
- 养成「开始 pull，结束 push」的习惯
文件说明：
- 配套图示文件：
Git-Workflow.canvas（工作流程图） - 配套图示文件：
Two-Place-Workflow.canvas（两地协作图） - 完整详细版：
Git-Teaching-Outline.md
讲义版本：v1.0
更新时间：2026-04-02
