第8章 Git入门与协作

作业v1.doc
作业v2.doc
作业v3_最终版.doc
作业v3_最终版_改.doc
作业v3_最终版_改_真的是最终版.doc    ← 你是不是也这样？

Git 帮你彻底告别这种混乱。

第一步：创建仓库

# 创建项目文件夹并进入
mkdir my-blog && cd my-blog

# 初始化 Git 仓库（会在文件夹里创建 .git 隐藏目录）
git init
# 输出：Initialized empty Git repository in .../my-blog/.git/

第二步：创建文件并提交

# 创建项目文件
echo "# 我的博客" > README.md
echo "<h1>我的博客</h1>" > index.html

# 查看状态（红色=未跟踪/已修改）
git status
# 会显示 README.md 和 index.html 是 "Untracked files"（未跟踪）

# 把文件添加到暂存区
git add README.md index.html

# 再看状态（绿色=已暂存，准备提交）
git status
# 会显示 "Changes to be committed"

# 提交到本地仓库
git commit -m "初始化博客项目：添加 README 和首页"
# 输出：[main (root-commit) xxxx] 初始化博客项目...

第三步：修改并再次提交

# 修改文件
echo "<h1>我的博客</h1><p>欢迎来到我的博客</p>" > index.html

# 查看修改了什么
git diff
# 会显示具体改了哪些行

# 添加并提交
git add index.html
git commit -m "feat: 首页添加欢迎语"

第四步：推送到 GitHub

首先在 GitHub 上创建一个新仓库（网页操作），然后：

# 关联远程仓库（把下面的 URL 换成你自己的）
git remote add origin https://github.com/你的用户名/my-blog.git

# 第一次推送（-u 设置默认关联）
git push -u origin main

# 以后直接用
git push

第五步：拉取更新

如果别人（或你在另一台电脑上）推送了新代码：

# 拉取远程的最新代码
git pull

# 查看当前分支
git branch
# * main（星号表示当前分支）

# 创建新分支
git branch feature/dark-mode

# 切换到新分支
git checkout feature/dark-mode
# 或者用新命令（推荐）：
git switch feature/dark-mode

# 创建并切换（一步到位）
git checkout -b feature/dark-mode
# 或：
git switch -c feature/dark-mode

# 在新分支上开发
echo "body { background: #222; color: #fff; }" > dark.css
git add dark.css
git commit -m "feat: 添加暗色模式样式"

# 切回主分支
git switch main

# 合并新分支到主分支
git merge feature/dark-mode

# 删除已合并的分支（可选，保持整洁）
git branch -d feature/dark-mode

# 模拟冲突：两个分支都修改了 index.html
# 分支 A：<h1>版本A</h1>
# 分支 B：<h1>版本B</h1>

# 合并时 Git 会提示冲突
git merge feature/branch-b
# CONFLICT (content): Merge conflict in index.html

打开冲突文件，会看到类似这样的内容：

<<<<<<< HEAD
<h1>版本A</h1>
=======
<h1>版本B</h1>
>>>>>>> feature/branch-b

第一步：Fork 仓库

在 GitHub 上打开你想贡献的项目，点右上角的 Fork 按钮。这会在你的账号下创建一份该项目的副本。

原始仓库：https://github.com/原作者/awesome-project
你的副本：https://github.com/你的用户名/awesome-project

第二步：克隆你的 Fork 到本地

git clone git@github.com:你的用户名/awesome-project.git
cd awesome-project

第三步：创建新分支并修改

# 创建并切换到新分支
git switch -c fix/typo-in-readme

# 修改文件（比如修了个错别字）
# ...编辑 README.md ...

# 提交修改
git add README.md
git commit -m "docs: 修复 README 中的错别字"

第四步：推送到你的 Fork

git push origin fix/typo-in-readme

第五步：创建 Pull Request

1. 打开你的 Fork 页面（github.com/你的用户名/awesome-project）
2. GitHub 会自动提示"你刚推送了新分支，要不要创建 PR？"点 Compare & pull request
3. 填写 PR 标题和描述（说明你改了什么、为什么改）
4. 点 Create pull request

第六步：等待 Code Review 和合并

• 项目维护者会审查你的代码（Code Review）
• 可能会要求你修改（在同一个分支继续提交就行）
• 审核通过后，维护者点 Merge pull request 合入主分支