Git 版本控制从入门到远程协作实战

2.2 记录足迹 - 添加与提交

添加 (git add) 将工作区的变更添加到暂存区。

# 仅指定文件
$ git add <filename>
# 当前目录所有新增/修改
$ git add .
# 所有变更（包括删除）
$ git add -A

提交 (git commit) 将暂存区的变更打包成历史记录。

# 提交并附带说明
$ git commit -m "清晰、有意义的提交说明"

2.3 时光回溯 - 查看历史与差异

翻阅日志

# 简洁模式
$ git log --oneline
# 图形化展示分支关系
$ git log --graph --oneline --all

查看差异

# 比较工作区与暂存区
$ git diff
# 比较暂存区与本地仓库
$ git diff --staged
# 比较两个提交
$ git diff <commit1> <commit2>

查看快照

# 查看最新提交详情
$ git show
# 查看特定提交
$ git show <commit_hash>

3. 协作基石 - 分支与合并

3.1 开辟平行宇宙 - 分支

分支是 Git 最强大的功能之一，允许你在不影响主线的情况下进行实验。

# 创建分支
$ git branch <分支名>
# 切换分支
$ git switch <分支名>
# 创建并切换
$ git switch -c <新分支名>
# 查看所有分支
$ git branch -a

3.2 合而为一 - 合并

将其他分支的代码整合到当前分支。

# 合并指定分支
$ git merge <待合并分支>

4. 连接世界 - 远程仓库与协作

4.1 配置远程仓库

远程仓库托管在网络服务器上，作为代码共享与协作的中央枢纽。

生成 SSH 密钥

# 生成密钥对
$ ssh-keygen -t ed25519 -C "关联邮箱"
# 查看公钥
$ cat ~/.ssh/id_ed25519.pub

关联远程仓库

# 添加远程仓库
$ git remote add origin https://gitee.com/yourname/yourrepo.git
# 查看远程地址
$ git remote -v

4.2 推送与拉取

克隆项目

$ git clone https://gitee.com/yourname/yourrepo.git

获取更新

# 仅获取远程更新（不自动合并）
$ git fetch origin
# 获取并自动合并
$ git pull origin main

上传代码

# 首次推送建立追踪
$ git push -u origin main
# 后续简化推送
$ git push

5. 撤销与修复

5.1 后悔药？ - 撤销与重置

撤销工作区修改 丢弃未暂存的修改。

$ git checkout -- test.txt
# 或新版命令
$ git restore test.txt

撤销暂存区修改 将文件从暂存区撤回。

$ git reset HEAD test.txt
# 或新版命令
$ git restore --staged test.txt

修改最新提交 补充漏掉的文件或修改注释。

$ git add 漏掉的文件
$ git commit --amend

回退提交

# 软回退（保留更改）
$ git reset --soft HEAD~1
# 硬回退（丢弃更改，慎用）
$ git reset --hard HEAD~1
# 安全回退（创建新提交抵消旧提交）
$ git revert <commit_id>

常用 Git 命令速查表

掌握这些核心命令，你就已经具备了独立管理代码版本的能力。在实际工作中，多动手实践，遇到冲突时冷静分析，Git 会成为你开发中最得力的助手。