从前言来看，为什么需要版本控制？

很多团队仍在使用“项目文件夹备份v1 → v2 → 最终版”等方式管理代码。这种做法带来的痛点不容忽视：

• 多人协作难：每个人的代码都保存在本地，合并只能手动复制粘贴，稍有不慎就会覆盖他人的工作，导致冲突频发。说起来，
• 缺乏版本概念：硬盘损坏或误删代码后无法回退。只能靠手工备份，风险极高。
• 工程化不足：谁改了什么、什么时候改的、为什么改的这些信息没有记录，审查和追溯变得困难。

Git 完整的文件快照，随时可以回到历史任意版本；提供了中央仓库作为团队共享网站，实现高效协作。

Git 是分布式版本控制程序。每个开发者本地都有完整仓库副本，即使服务器宕机也能恢复全部历史。这与传统集中式程序形成鲜明对比——后者的历史只保存在唯一服务器上，一旦失效则所有记录丢失。

git init：初始化仓库

git init

该命令将当前普通目录升级为具有版本控制能力的 Git 仓库。执行后会在目录下生成隐藏文件夹 .git它是仓库的心脏存放所有提交历史、暂存区信息、分支与标签还有配置。

注意：.git 目录绝不能手动修改，否则极易导致仓库损坏。所有操作必须通过 Git 命令完成。

使用者痛点：新手常误删 .git 或误改其中文件，导致整个项目无法恢复。建议在任何操作前先执行 git status 检查当前状态。

至于文件状态。三个阶段的流转

Git 中的文件从创建到入库经历三种主要状态：

• Untracked：新建文件默认处于此状态，仅被 Git 感知但不受管理。老实说，git status 会以红色标出。
• Staged：git add 后进入暂存区，表示“下次提交时把当前内容保存为快照”。
• Committed：git commit 后暂存区内容永久写入仓库，此时文件状态为“干净”。

使用者痛点：经常忘记执行 end git add . && git commit -m "msg"。结果代码在本地修改却未提交，被同事覆盖或丢失。

git add 与 git commit：为何要分两步？

This two‑step design is core of Git’s flexibility.

# 示例：分批暂存
git add index.html # 第一次 add
git add common.css # 第二次 add
git add common.js # 第三次 add
git commit -m "完成首页页面功能"

The tagging area ) acts as a buffer 娱乐ween working directory and repository:

• #1 精细控制提交粒度：A single commit corresponds to a complete feature or task rar than scattered file changes. 清晰的提交信息是 Code Review 的第一入口。
• #2 “后悔”机制：You can run git status,review staged files,and use git reset ` to unstage any mistake before committing.
• #3 工作流灵活性：If an urgent bug appears。you can leave unfinished changes unadded while keeping a clean staged snapshot.

git status：你的状态教程针

git status

"先看状态，再行动" ——这是每位开发者应养成的肌肉记忆。

• Status 输出内容：
• ACTION 时机：
• - 开始编码前确认工作区干净；怎么说呢，
• - 每次 Add  后 检查确保只暂存了预期文件；
• - Commit 前最终一次核对，以免遗漏关键改动。

Pain point: 很多新人在合并冲突后直接跑 `git pull` 而不查看 `status`。 导致未解决冲突就继续开发，引发更大混乱。养成每一步都先 `status` 的习惯，可大幅降低此类风险。

远程仓库的观点是。连接团队成员

# 将本地仓库关联到远程网站
git remote add origin <仓库URL>
# 推送本地 main 分支到远程
git push -u origin main
# 拉取远程最新代码
git pull origin main

`origin` 是默认别名，可自行更换。怎么说呢，关联后通过 `push` 将本地提交同步至云端。通过 `pull` 拉取同事最新代码，实现协同开发。

Pain point: 忘记设置 upstream导致每次 push 必须手动写完整命令 `"fatal: The upstream branch of your current branch does not match"`。首次 push 时加上 `-u` 可省去后续重复输入。

主流远程网站比较

/// // Note: above rows intentionally contain malformed markup for demonstration?说起来，No – fix m.

网站	特点
GitHub	全球最大开源社区，多语言环境丰富，CI/CD 集成完善
Gitee	国内打开速度快。中文文档友好，对公司免费额度友好
GitLab 支持私有化部署，自带 CI/CD 与 DevOps 流水线
GitLab	支持私有化部署。自带 CI/CD 与 DevOps 流水线

日常工作流示例

# 1️⃣ 开工前确认状态
git status
# 2️⃣ 将修改加入暂存区
git add file1.js
git add file2.css
# 3️⃣
检查暂存内容
git status
# 4️⃣ 提交到本地仓库
git commit -m "实现登录页 UI"
# 5️⃣ 推送到远程主分支
git push origin main
# 6️⃣ 拉取同事最新代码保持同步
git pull origin main

Cores原则：

• Add 可以多次但一次 Commit 对应一次完整功能；
Status​​​​​​​​​​​​​​​​​‌‍‍‍‍‍‍‍‍‌‌‌‌‌‌‌‌​​‌‌​​‌​​‏‏‏‏‏‏‏‏‏‎‎‎‎‎‏‎‎‎­­‑–—‑–––—‑–—‑–––—–——­­‑–\-\-\-\-\-\-\-\-\-\-\- * Actually this list should be concise.* **** Sorry let's correct. Actually we should rewrite that part: */ Oops. Let's provide corrected list: */ Corrected:
• Add 可以多次但一次 Commit 对应一次完整功能或任务；
` ... But we need final valid HTML. Let's rewrite that segment correctly.

大多数团队仍采用 “项目文件夹备份 v1 → v2 → 最终版” 的方式管理代码。这种做法会带来以下痛点：

• P1 – 多人协作困难： 每个人都在自己的电脑上单独编辑代码，合并只能手动复制粘贴，一旦操作失误就会覆盖他人的工作，引发冲突。
• P2 – 缺乏回滚能力： 硬盘损坏或误删代码后无法恢复。只能靠手工备份，风险极高。
• P3 – 工程化不足： 谁改了什么、什么时候改的、为什么改的这些关键信息没有记录，使得审查和追溯异常困难。

为了解决上述问题。Git 引入了 “快照” 概念，每一次提交都会生成完整文件快照，可随时回到历史任意节点；提供了
中央仓库作为团队共享网站，实现高效协作。Git 是分布式版本控制程序，每个开发者本地都有完整仓库副本，即使服务器宕机也能恢复全部历史。这与传统
集中式程序形成鲜明对比——后者只在唯一服务器保存历史，一旦失效则所有记录丢失。

git init ： 初始化 仓 库 / h २>

 git init
/ code>

该 命令 将 当前 普 通 目 录 升级 为 拥 有 版 本 控 制 能 力 的 Git 仓 库。话说回来，执 行 后 会 在目录下生成 隐 藏 文 件夹 . git / code>。它 是 仓 库 的 心 脏 / strong>，存 放 所 有 提交 历史 、 暂 存 区 信 息 、 分 支 与 标 签 还有 配置。老实说，

注意 ： / strong> 不要 手 动 修改 . git 目 录 中 任 意 文 件。否 则 极 易 导 致 仓 库 损 坏。所 有 操 作 必 须 通 过 Git 命令 完 成。

使用者 痛 点 ： / strong> 新 手 常 因 不 小 心 删除 或 改 动 . git 中 的 元 数据，导 致 项目 无 法 恢复。建议 在 任 意 操 作 前 首 先 执 行 git status / code> 检 查 当 前 状 态。其实，

---