Git 是一个分布式版本控制程序可以记录文件的每次修改，方便多人协作、回溯历史、分支开发与合并。

对开发者“管理 Git 仓库”就是学习如何创建仓库、提交更改、创建分支、与远程仓库交互还有解决冲突等主要操作。

二、安装与首次配置

1️⃣ 安装 Git

• Windows下载 Git for Windows 安装包，按向导安装即可。
• macOS终端执行 xcode-select --install 或通过 Homebrew 安装：brew install git
• Linux使用包管理器。如 Ubuntu 执行 sudo apt install git

痛点：在 Linux 上缺少 Git 会导致建立脚本报错，请先确认已安装。

2️⃣ 基本配置

git config --global user.name "你的名字"
git config --global user.email ""

这些信息会嵌入到你的每一次提交中。老实说，

痛点："使用者名或邮箱不匹配" 常见于团队审核时导致 PR 拒绝。请务必检查配置是否正确，

• # 换行符自动转换 git config --global core.autocrlf input # macOS/Linux # 设置默认分支名为 main git config --global init.defaultBranch main # 启用颜色 git config --global color.ui auto
• 查看全部配置：git config --list

三、创建仓库

A️⃣ 从零初始化新仓库

mkdir my-project
cd my-project
git init 

This will create a hidden .git folder for version database.

B️⃣ 克隆现有仓库

# 示例
git clone https://github.com/user/repo.git
# 或者使用 SSH：
git clone :user/repo.git my-folder 

Keen to know: After cloning you’ll automatically have a remote named origin pointing to source URL.

四、工作区 / 暂存区 / 版本库概念梳理

• 工作区:          你本地能看到的文件。
• 暂存区: 临时保存将要提交的修改。
• 版本库: `.git`目录，存有所有提交历史。

Status flow: Untracked → Staged → Committed → Modified → Staged .

五、基本快照操作教程

A️⃣ 查看当前状态 & 确认改动范围

git status 

"未跟踪"。"已修改但未暂存"，和 "已暂存待提交" 的文件都会显示来。说到常见痛点，忘记 `add` 新文件导致 `push` 时提示 “nothing to commit”。其实，请先确认状态后再执行后续操作。

B️⃣ 添加文件到暂存区

`

// 指定文件
git add <文件名>
// 当前目录所有改动
git add .
// 所有改动
git add -A
// 仅添加修改和删除。不包含新文件
git add -u
`
**痛点**这方面，误用 `-A` 导致意外删除被追踪的旧文件。

C️⃣ 提交变更 
`
`

git commit -m '简洁说明更新内容'
`如果想直接提交已跟踪文件的变更而跳过 `add` ：
text
git commit -a -m '直接提交所有已跟踪文件的修改'
**注意**的观点是，该命令不会添加未跟踪的新文件。`

D️⃣ 查看差异 
`
`

# 工作区与暂存区的差异
git diff
# 暂存区与最近一次提交的差异
git diff --staged
# 工作区+暂存区 与 最新提交 的差异
git diff HEAD
# 两次提交之间的差异
git diff  
`
再看**痛点**。在冲突后 `diff` 能快速定位冲突行，但需注意前后文对比才能正确解决。不过，`

E️⃣ 删除或移动文件 
`
`

# 删除工作区文件并暂存删除操作
git rm 
# 仅从暂存区删除保留工作区文件
git rm --cached 
# 重命名并自动暂存
git mv  <:newname>
`
再看**痛点**。误删关键源码导致无法恢复；建议先备份或使用 `stash` 临时保存。`

六、.gitignore 忽略规则设置技巧
`

`

Create `.gitignore` at repo root.

Add patterns:
text
# 忽略 node_modules 目录
node_modules/
# 忽略所有 .log 文件
*.log
# 忽略特定密钥文件
secret.key
# 不忽略关键日志，用!前缀取反：
important.log

Copy template from official .
未忽略生成产物导致大体积 repo；请务必检查 ignore 是否覆盖了临时编译输出。老实说，

七、查看提交历史



命令
用途




git log
显示完整历史


git log --oneline
单行简洁显示


git log --graph --oneline
图形化分支结构


git log --stat
每次提交修改统计


-n X。--author=“X”,etc…




至于示例，text

git log -

git log --author="xiaoming"


查看某一次具体差异：
text
$ git show 
$ git show HEAD # 最新一次。按理说，

八、撤销与回退技巧

A️⃣ 修改最终一次提交

如果只漏加了个新文件。可先 add` 再执行：

text
$ git commit --amend -m '新的信息'

⚠️ 若已推送至远程，请避免使用 amend，以免破坏公共历史。

B️⃣ 撤销暂存

把已经 added` 的内容移回工作目录：

text
$ git restore --staged <>
$ 或 $ git reset HEAD <>


C️⃣ 丢弃工作区修改

完全抛弃当前未 committed 的更改：

text
$ git restore <>
$ 或 $ git checkout -- <>

注意：此操作不可逆；请慎重，

D️⃣ 历史回退

三个级别可根据需要选择：



模式
行为




soft
保留 staged 与 working tree


mixed
把 HEAD 移回。但保留 working tree 改动


hard
严格移除所有改动，包括 working tree




示例这方面，text
$ git reset --soft HEAD~ # 回退到上一次但保持 staging 区域不变。$ 或 $ sudo rm -rf ./dist # 如果是编译产物，可单独处理。$ 或 $ rm -rf ./build #
$ $ sudo npm run build #
...

⚠️ “hard” 极其危险——任何未推送本地更改都将永久丢失！不过，

E️⃣ 安全撤销

当你想撤销一段已经推送给他人的代码但不想破坏历史：

text
$ git revert <>

这会产生一个新的逆向 commit 并保留整个变更轨迹。

九、远程仓库操作实战

A️⃣ 

例如连接 Github 仓库：

text
$  git remote add origin  https://github.com/user/repo.git 

B️⃣ 查看远程信息

text
$  git remote -v   # 显示 URL 列表
$  git remote show origin     # 更详细的信息，包括追踪分支等。怎么说呢，

C️⃣ 推送本地代码至远程

第一次推送需要显式建立上游追踪关系：

text
$  git push -u origin main     # 建立 upstream 并推送；随后可直接 `$ ​​​​​​​​​​ ​​​push`.


D️⃣ 从远程拉取数据而不合并

安全获取最新信息但保持当前代码状态：

text
$ git fetch origin


E️⃣ 拉取并合并

于 fetch + merge:

text
$ git pull origin main 

十、一键解决常见推送冲突流程


本地尝试 push` 时得到 “Updates were rejected because tip of your current branch is behind its remote counterpart.”；

拉取最新代码这方面。text
$ gti fetch origin
$ gti rebase origin/main


若出现冲突手动解决后标记为 good，接下来继续 rebase/pull；

最终
push`。怎么说呢，


十一、多分支协作流程图解


主干稳定线 ➜ main

功能开发线 ➜ feature/


从流程示例来看。1. 克隆项目 → 创建功能分支；2. 开发完成 -> Stage -> Commit -> Push；3. 在网站发起 PR 并合并至主干；4. 合并后删除 feature 分支。

再看示例脚本，



# 简易 Feature 开发流程脚本 Demo 




$ ​clone repository
$ ​switch to main
$ ​pull latest changes
$ ​create new branch
$ …coding ，


$ ​add all files
$ ​commit
$ ​pull latest changes from main and rebase
$ ​resolve any conflicts if necessary
$ ​push branch up to remote 

$ On platform create PR and merge into main
$ Delete local and remote feature branch after success!话说回来，

🛠️ 注意事项：

• Keep local branch updated with upstream before merging.
• Rebase onto latest main for cleaner history.
• Avoid rebasing public commits.






🔗 链接 : https://docs.github.com/en/get-started/quickstart/fork-a-repo 



💡 小贴士 ： 使用标签标记发布版本。






十二、高效查阅和调试工具集锦

A．逐行溯源

帮助定位谁在何时写下某行代码。

从示例来看，


summary Blame Demo




summary Bisect Demo



summary Grep Demo





十三、更安全地重写历史

A．交互式变基

用于编辑最近几条 commit，例如合并多条修复为单条或者删掉无关日志。说起来，

再看典型命令。bash
gti rebase -i HEAD~5 # 编辑最近5次提交流量


编辑器中可选择以下动作：


pick – 保留原样。

reword –
此 Commit 信息。

squash/fixup – 合并到上一条 Commit。

drop – 删除此 Commit 完全消失。


完成后若出现冲突，用标准方法解决再执行 rebase‐continue〉；若决定放弃则 rebase‐abort〉。老实说，

B．高阶工具

当需要彻底清除敏感信息或者大规模重构作者身份时可考虑使用官方推荐工具—— 或者 Python 实现。这些工具可以批量删除指定方法或替换作者名称。但务必在私有仓库中测试，并提前备份整棵树！话说回来，


十四、一键速查表格整理版


常用 Git 命令速查表 










 初始化仓库  gti init ...?,，?，...



 克隆仓库  gti clone ⟨url⟩ ...?...，...



 检查状态  gti status ...?，…...，?，…..，?，?


...

Truncated due dynamic placeholders due time limit—complete table omitted for brevity…






阅读更多参考资料 => https://www.atlassian.com/git/tutorials · https://www.tutorialspoint.com/git/
--> 




十五、高效日常实践建议


始终先检查状态——在做任何重大变更之前执行 status〉 并确保没有隐藏问题。

使用 Branching Workflow 固定规范


主干始终稳定且可随时部署。说起来，

功能开发采用短期 Feature Branch 并及时 Rebase 到主干当前版本以避免大规模 Merge Conflict。说起来，



标签发布常用方法


对每个正式 Release 创建带注释的 Tag。如 v1.4.7-娱乐a.

推送标签至远端以便 CI/CD 自动识别部署目标。



持续学习和复盘


定期浏览自己的 .log。.blame,和 .diff;写 README 中记录常见误解还有对应解法，让新人快速上手。




祝你在前端项目里玩转 Git，从此不再被「Merge 冲突」或「意外丢失」所困扰！