第24讲：Git项目管理与获取

工作区 (Working Directory)
    |
    |  git add
    v
暂存区 (Staging Area / Index)
    |
    |  git commit
    v
本地仓库 (Local Repository)
    |
    |  git push  (到远程)
    v
远程仓库 (Remote Repository)

未跟踪 (Untracked)
    |
    |  git add
    v
已暂存 (Staged)
    |
    |  git commit
    v
已提交 (Committed)
    |
    |  修改文件
    v
已修改 (Modified)
    |
    |  git add
    v
已暂存 (Staged)  ...（循环）

https://git-scm.com/

git --version
# 输出示例：git version 2.42.0.windows.1

# 1. 更新软件源
sudo apt update

# 2. 安装Git
sudo apt install git

git --version
# 输出示例：git version 2.40.0

# 配置全局用户名（所有仓库通用）
git config --global user.name "你的名字"

# 配置全局邮箱
git config --global user.email "your_email@example.com"

# 示例
git config --global user.name "张三"
git config --global user.email "zhangsan@foxmail.com"

# 设置为 vim（推荐，Linux 环境默认）
git config --global core.editor vim

# 设置为 nano
git config --global core.editor nano

# Windows 下设置为 VS Code
git config --global core.editor "code --wait"

# Windows 下设置为 Notepad++
git config --global core.editor "'C:/Program Files/Notepad++/notepad++.exe' -multiInst -notabbar -nosession -noPlugin"

# 查看所有配置项
git config --list

# 查看全局配置
git config --global --list

# 查看某个具体配置项的值
git config user.name
git config user.email

# 设置别名
git config --global alias.st status
git config --global alias.co checkout
git config --global alias.br branch
git config --global alias.ci commit
git config --global alias.lg "log --oneline --graph --all"

# 使用别名
git st       # 等价于 git status
git co main  # 等价于 git checkout main
git lg       # 等价于 git log --oneline --graph --all

# 创建新目录
mkdir my_project
cd my_project

# 初始化 Git 仓库
git init
# 输出：Initialized empty Git repository in /path/to/my_project/.git/

# 查看生成的 .git 隐藏目录
ls -la
# 看到 .git 目录即表示初始化成功

# 暂存单个文件
git add filename.c

# 暂存多个指定文件
git add file1.c file2.h

# 暂存当前目录下所有改动
git add .

# 暂存整个仓库的所有改动
git add -A   # 或 git add --all

# 1. 创建一个新文件
echo "# My Project" > README.md

# 2. 查看状态（此时 README.md 是"未跟踪"状态）
git status

# 3. 暂存文件
git add README.md

# 4. 再次查看状态（README.md 变为"已暂存"状态）
git status

# 提交并附带简要说明（最常用）
git commit -m "添加 README 文件"

# 提交时自动暂存所有已跟踪文件的修改（跳过 git add）
git commit -am "修改了 main.c 的初始化逻辑"

# 提交并打开编辑器，编写详细的提交说明
git commit

git status

On branch main
Changes to be committed:
  (use "git restore --staged <file>..." to unstage)
        new file:   README.md

Changes not staged for commit:
  (use "git add <file>..." to update what will be committed)
        modified:   main.c

Untracked files:
  (use "git add <file>..." to include in what will be committed)
        temp.log

git status -s   # 或 git status --short

# 输出：
# A  README.md      (A = Added，新增已暂存)
#  M main.c           (右边M = Modified，已修改但未暂存)
# ?? temp.log         (?? = Untracked，未跟踪)

# 查看完整提交日志
git log

# 简洁模式，每次提交一行
git log --oneline

# 图形化显示分支合并历史
git log --oneline --graph

# 显示所有分支的历史
git log --oneline --graph --all

# 限制显示最近 N 条
git log --oneline -5

# 查看工作区与暂存区的差异（即还没 git add 的改动）
git diff

# 查看暂存区与最新提交的差异（即 git add 了还没 git commit 的）
git diff --staged   # 或 git diff --cached

# 查看工作区与最新提交的差异（跳过暂存区）
git diff HEAD

# 查看两个提交之间的差异
git diff commit1 commit2

# 查看某个文件的改动
git diff -- filename.c

# 创建一个目录存放项目
mkdir my_project
cd my_project

# 克隆远程仓库
git clone https://github.com/用户名/仓库名.git

# 克隆到指定目录名（而非默认的仓库名）
git clone https://github.com/user/repo.git my-custom-dir

# 只克隆最近一次提交的历史（深度为1），加快下载速度
git clone --depth 1 https://github.com/user/repo.git

# 克隆指定分支
git clone -b develop https://github.com/user/repo.git

# GitHub 克隆（国外服务器，速度可能较慢）
git clone https://github.com/xxx/project.git

# Gitee 克隆（国内服务器，速度快）
git clone https://gitee.com/xxx/project.git

git pull

Already up to date.

git pull = git fetch + git merge

# 从远程仓库下载所有更新，但不合并
git fetch

# 从指定的远程仓库下载
git fetch origin

# 下载后可以查看远程分支的变化
git log origin/main   # 查看远程 main 分支的提交历史

# 1. 先查看远程变化（安全）
git fetch origin

# 2. 查看远程分支和本地的差异
git log main..origin/main   # 远程比本地多了哪些提交

# 3. 确认无误后再合并
git merge origin/main

# 为本地仓库添加一个远程仓库，取名为 origin（约定俗成的名称）
git remote add origin https://github.com/用户名/仓库名.git

# 示例
git remote add origin https://github.com/zhangsan/my-linux-driver.git

# 查看已关联的远程仓库信息
git remote -v

# 输出示例：
# origin  https://github.com/zhangsan/my-linux-driver.git (fetch)
# origin  https://github.com/zhangsan/my-linux-driver.git (push)

# 将本地 main 分支推送到远程 origin
git push origin main

# 首次推送（设置上游分支，之后可以简写为 git push）
git push -u origin main

# 设置上游后，之后的推送只需：
git push

# 重命名远程仓库（将 origin 改为 upstream）
git remote rename origin upstream

# 删除远程仓库关联
git remote remove origin

    main (主分支)
      |
      *---*---*---*---*---* (最新提交)
          |
          *---*---* (feature-login 功能分支)
          |
          *---* (fix-bug-101 修复分支)

# 查看本地分支（当前分支前有 * 号标记）
git branch

# 查看远程分支
git branch -r

# 查看所有分支（本地 + 远程）
git branch -a

# 方法一：git checkout（传统方式）
git checkout -b feature-login
# 等价于：
# git branch feature-login    创建分支
# git checkout feature-login   切换分支

# 方法二：git switch（Git 2.23+，语义更清晰，推荐）
git switch -c feature-login
# 等价于：
# git switch feature-login    切换到已有分支

git checkout main      # 传统方式
git switch main        # 新方式（推荐）

# 1. 先切换到目标分支（比如 main）
git switch main

# 2. 将 feature-login 分支合并到当前分支
git merge feature-login

# 合并过程可能产生冲突，需要手动解决后：
git add .
git commit -m "解决合并冲突"

# 删除已合并的分支
git branch -d feature-login

# 强制删除（即使未合并）
git branch -D feature-login

# 删除远程分支
git push origin --delete feature-login

main
  |
  +-- develop (开发分支，日常开发在这里)
  |     |
  |     +-- feature-a (功能分支)
  |     +-- feature-b (功能分支)
  |     +-- fix-issue-42 (修复分支)
  |
  +-- release (发布分支)

# 撤销某个文件的工作区修改（回到最近一次 git add 或 git commit 的状态）
git restore filename.c

# 撤销所有工作区修改
git restore .

# 从暂存区移出（即"撤销 git add"，但保留工作区的修改）
git restore --staged filename.c

# 查看提交历史，找到要回退到的 commit 哈希
git log --oneline

# --soft：回退提交，但保留暂存区和工作区的修改
# （相当于"撤销 commit，不撤销 add"）
git reset --soft HEAD~1       # 回退最近 1 次提交
git reset --soft abc1234      # 回退到指定提交

# --mixed（默认）：回退提交和暂存区，但保留工作区的修改
# （相当于"撤销 commit 和 add，但不改文件"）
git reset HEAD~1
git reset --mixed abc1234

# --hard：彻底回退，丢弃所有修改（危险操作！）
git reset --hard HEAD~1
git reset --hard abc1234

# 撤销最近一次提交（生成一次新提交）
git revert HEAD

# 撤销指定的提交
git revert abc1234

# 注释：以 # 开头
# ===============================

# 忽略特定文件
secret.txt

# 忽略所有 .o 文件（编译中间产物）
*.o

# 忽略所有 .log 文件
*.log

# 忽略特定目录（路径后的 / 表示目录）
build/
temp/
output/

# 忽略所有 .a 文件，但 libfoo.a 除外
*.a
!libfoo.a

# 只忽略根目录下的 TODO 文件，不忽略子目录的
/TODO

# 忽略 doc 目录下所有 .pdf 文件
doc/**/*.pdf

# 编译产物
*.o
*.ko
*.mod.c
*.mod
*.symvers
*.order
*.bin
*.elf
*.hex

# 编辑器/IDE
.vscode/
.idea/
*.swp
*.swo
*~

# 系统文件
.DS_Store
Thumbs.db

# 编译输出目录
build/
output/

# 密码/密钥（绝对不能提交）
*.key
*.pem
config/private.conf

  新建仓库
     |
     v
  git init (或 git clone)
     |
     v
  写代码，修改文件
     |
     v
  git add .          <!-- 暂存改动 -->
     |
     v
  git commit -m "..." <!-- 提交到本地仓库 -->
     |
     v
  git push            <!-- 推送到远程仓库 -->
     |
     (循环)

# 初始化或克隆
git init   # 或 git clone xxx

# 写一些代码后...
git add main.c
git commit -m "实现 GPIO 初始化函数"

# 继续修改...
git add -A
git commit -m "添加 UART 驱动框架"

# 查看历史
git log --oneline

# 推送到远程（如果有的话）
git push

1. Fork 原仓库（在 GitHub 网页上操作，复制一份到自己名下）

2. Clone 自己的仓库到本地
   git clone https://github.com/你的用户名/仓库名.git
   cd 仓库名

3. 添加上游仓库（方便同步更新）
   git remote add upstream https://github.com/原作者/仓库名.git
   git remote -v     <!-- 确认 origin 和 upstream 都配好了 -->

4. 创建功能分支
   git switch -c feature-my-uart

5. 写代码 + 提交
   git add .
   git commit -m "添加 UART DMA 模式驱动"

6. 推送到自己的远程仓库
   git push -u origin feature-my-uart

7. 在 GitHub/Gitee 网页上创建 Pull Request (PR)
   从 "你的仓库/feature-my-uart" 向 "原仓库/main" 发起 PR

8. 等待代码审查，根据反馈修改后继续 push，PR 会自动更新

9. 合并后清理本地分支
   git switch main
   git branch -d feature-my-uart

# 1. 从上游仓库下载更新
git fetch upstream

# 2. 切回 main 分支
git switch main

# 3. 合并上游 main
git merge upstream/main

# 4. 推送到自己的 origin（可选）
git push origin main

ls
cd 项目目录