Git 版本控制系统入门及 Gitee 远程仓库协作指南。内容涵盖 Git 安装配置、本地工作区与暂存区概念、分支管理策略、SSH 公钥配置及远程仓库同步操作。通过实际场景演示代码推送、拉取、合并流程，并提供历史版本查看与回退方法，帮助开发者掌握代码版本控制核心技能。
Gitee（码云）是开源中国推出的本土化 Git 代码托管与研发协作平台，核心提供代码存储、版本控制、团队协同开发功能，还支持项目管理、CI/CD 流水线、静态网站部署等能力。
Git 是一个分布式版本控制系统。可以把它想象成一个能记录你每一次代码修改的'时光机'。你可以随时回到过去的任何一个版本，也可以放心地开辟一个新的'平行时空'（分支）去尝试新功能，而不用担心会搞乱主线代码。
如果说 Git 是管理你本地代码的'时光机'，那么 Gitee（或者 GitHub）就是一个远程代码仓库，一个云端的'代码银行'。你可以把本地的代码'存款'（推送）到 Gitee 上，方便备份，也方便和团队成员共享、协作。
在开始使用 Git 之前，你需要先'自报家门'，告诉 Git 你是谁。这样，在未来的每一次提交中，Git 都会记录下你的大名。
打开你的终端（在 Windows 上可以是 Git Bash），输入以下命令：
# 配置你的用户名
git config --global user.name "你的用户名"
# 配置你的邮箱地址
git config --global user.email "你的邮箱地址"
提示：这里的用户名和邮箱只是一个标识，你可以使用你的 Gitee 或 GitHub 账户信息，也可以自定义。
配置完成后，你可以使用以下命令来查看所有配置信息：
git config --list
要理解 Git，必须先了解它的三个核心区域：
首先，在你电脑上创建一个新的文件夹（或者进入一个已有的项目文件夹），然后执行：
git init
这个命令会在当前目录下创建一个 .git 的隐藏文件夹，标志着你的本地 Git 仓库初始化成功！
这是 Git 最核心、最常用的操作流程。
第一步：检查状态
使用 git status 命令，它可以告诉你当前仓库的状态。
git status
第二步：添加到暂存区
当你完成了一个小阶段的修改后，需要把这些改动从工作区'登记'到暂存区。
# 添加所有已修改的文件到暂存区
git add .
提示：
.代表当前目录下的所有改动。你也可以指定单个文件，如git add index.html。
第三步：提交到版本库
将暂存区的所有内容正式'存盘'，形成一个新的历史版本。
git commit -m "这里写本次提交的说明信息"
强烈建议：
-m后面的提交信息一定要写得清晰明了，比如'修复了登录页面的 bug'、'增加了用户注册功能'。这将有助于你日后回顾查看！
分支是 Git 的'杀手级'功能！它允许你创建一个主线（通常是 master 或 main）的副本，在这个副本上随心所欲地开发新功能，完成后再安全地合并回主线。
| 操作 | 命令 | 说明 |
|---|---|---|
| 查看分支 | git branch | 列出所有本地分支，当前分支前会有一个 * 号 |
| 创建分支 | git branch <新分支名> | 基于当前分支创建一个新的分支 |
| 切换分支 | git checkout <分支名> | 切换到指定的分支去工作 |
| 创建并切换 | git checkout -b <新分支名> | 一步完成创建和切换两个操作，强烈推荐！ |
| 合并分支 | git merge <要合并过来的分支名> | 将指定分支的修改合并到当前所在的分支 |
| 删除分支 | git branch -d <分支名> | 删除一个已经合并过的分支 |
| 强制删除 | git branch -D <分支名> | 强制删除一个未合并的分支（请谨慎操作） |
| 重命名分支 | git branch -m <老分支名> <新分支名> |
假设你正在 master 分支上，突然需要开发一个新功能（比如'用户评价'）。
git checkout -b feature-comment // 创建并切换到一个名为 feature-comment 的新分支add 和 commit。git checkout master。git merge feature-comment。git branch -d feature-comment。现在，是时候将你的本地仓库和云端的 Gitee 连接起来了。
为了让你每次推送代码时不用反复输入用户名和密码，我们推荐配置 SSH 公钥。这就像是给你的本地电脑办了一张 Gitee 的'通行证'。
测试连接：
ssh -T [email protected]
如果看到 Hi [你的用户名]! You've successfully authenticated...，就说明配置成功了！
查看并复制公钥：
cat ~/.ssh/id_ed25519.pub
将输出的一长串以 ssh- 开头的内容完整复制下来。
生成 SSH 公钥：
# -C 后面可以是任意名字，通常用邮箱
ssh-keygen -t ed25519 -C "[email protected]"
执行后一路回车即可。
| 操作 | 命令 | 说明 |
|---|---|---|
| 关联远程仓库 | git remote add origin <远程仓库地址> | 将本地仓库与一个远程仓库地址关联起来，origin 是远程仓库的默认别名 |
| 克隆仓库 | git clone <远程仓库地址> | 从远程地址完整地复制一个项目到本地 |
| 推送代码 | git push -u origin <分支名> | 首次将本地分支的提交推送到远程仓库 |
git push | 后续推送，简化命令 | |
| 拉取代码 | git pull | 从远程仓库拉取最新的代码并与本地代码合并，每次写代码前和提交代码前都应执行 |
| 删除远程关联 | git remote remove origin | 解除本地与远程仓库的关联 |
git init, git add ., git commit ...git remote add origin [你的 Gitee 仓库 SSH 地址]git push -u origin mastergit clone [Gitee 仓库 SSH 地址]cd [项目文件夹]git add, git commit, git push 即可。git log: 查看详细的、完整的提交历史（提交者、日期、说明等）。git log --oneline: 以一行的形式展示精简的历史信息。git reflog: 查看你的所有操作记录，包括已经删除的 commit 和版本回退操作。这是你的'终极后悔药'！当你发现某个版本改错了，想回到过去时，就需要版本回退。
# 版本号就是通过 git log 或 git reflog 看到的哈希值（如：ede7b8e）
git reset --hard <版本号>
⚠️ 警告：
--hard参数会彻底丢弃你当前工作区和暂存区的所有改动，直接回到指定的版本。这是一个危险操作，执行前请务必确认你没有未保存的重要代码！
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online
将JSON字符串修饰为友好的可读格式。 在线工具，JSON美化和格式化在线工具，online