当前位置：首页 > news >正文

版本控制工具——Git

news 来源：原创 2025/8/25 21:05:44

【版本控制系统】

【Git概述】

【Git下载】

【Git初始化本地仓库并推送】

【克隆目标仓库】

【Git团队开发的一种流程】

【Git客户端TortoiseGit】

【下载、克隆和分支之间的区别】

【下载GitHub中的子文件夹】

【不用魔法的访问方法】

【GitHub官方文档】

【版本控制系统】

版本控制系统（version control system）是一种用于管理文件变更的软件工具，主要用于记录文件的修改历史，支持多人协作开发。用的比较多的如SVN，Git等。

特性	集中式 VCS (如SVN)	分布式 VCS (如Git)
存储方式	中央服务器存储所有版本数据	每个开发者都有完整的仓库副本
依赖中央服务器	是	否
离线操作	不支持	支持
分支管理	分支创建和合并较复杂	分支创建和合并简单高效
权限控制	集中管理，适合企业环境	分散管理，适合开源项目
代表工具	Subversion (SVN), CVS	Git, Mercurial
适用场景	小型团队，企业环境	大型项目，分布式团队，开源项目

一个例子直观理解：

特性	集中式：银行	分布式：加密货币（如比特币）
场景	所有用户的账户和交易记录都存储在银行的中央服务器	所有交易记录分布在多个节点（矿工）上，每个节点都有完整的交易记录副本
交易方式	用户需要通过银行的系统进行交易	用户可以直接与其他节点进行交易，不需要依赖中央服务器
服务器故障时	若银行的服务器故障，交易无法进行	即使部分节点故障，其他节点仍可以继续处理交易
特点	依赖中央节点（银行）	去中心化，不依赖中央节点

之前已经写了SVN的介绍的基本使用方法：版本控制工具——SVN-CSDN博客

【Git概述】

Git 是一个分布式版本控制系统，用于高效地管理项目文件的变更历史，支持多人协作开发。它通过创建快照（snapshot）来记录文件状态，允许用户轻松地回滚、分支和合并代码。Git 的优势在于其去中心化设计，每个开发者都有完整的项目历史，可以在离线状态下工作。

那么GitHub、Gitee、Gitlab、Gitea等和Git又有什么关系？

Git：

是一个本地软件，无需联网即可使用，实现本地代码的管理。

Github：

相当于位于国外的Git云服务器。是一家美国公司基于Git实现的在线代码仓库，目前全球最大的代码托管平台。只支持 git 作为唯一的版本库格式进行托管。共有仓库免费，建立私有仓库要收费。Github的初衷就是为了大家共享自己的劳动成果。

Gitee：

相当于位于国内Git云服务器。Gitee（码云）是一家中国公司，Github的中国化。不用自己搭建环境，可以建立自己的私有仓库
Gitlab / Gitea：

基于Git实现的支持自己部署的在线代码仓库平台。

功能复杂度：GitLab（复杂） > GitHub/Gitee（适中） > Gitea（简单）。
部署方式：GitLab/Gitea 支持自托管；GitHub/Gitee 主要为云服务。
联合使用：通过Git可以把本地文件上传到GitHub、Gitee、Gitlab、Gitea等网络仓库，同样也可以把网络仓库保存到本地

【Git下载】

下载地址：Git for Windows

安装成功后桌面右键会出现下面框选的内容：

【Git初始化本地仓库并推送】

# 完整流程示意图 #初始化本地仓库  →  暂存文件  →  提交到本地  →  关联远程仓库  →  推送到远程
(git init)        (git add)   (git commit)  (git remote)    (git push)

# 一个完整的从初始化本地仓库到推送代码到远程仓库的成功demo
git init    # 初始化
git add .   # 添加当前文件夹下所有新变更（新文件、修改过的文件）文件到缓存
git commit -m "first commit"   # 提交新变更，""内必填内容
# 以上为本地命令，以下为提交网络仓库需要的命令
git config –global user.name  "用户名"      # 设置用户名
git config –global user.email "用户邮箱"    # 设置邮箱
git config --global --list                 # 如果需要验证可以输入下面命令# 将远程仓库的URL关联到本地仓库，并命名为 origin（可自定义，但一般默认用origin），仅需在第一次关联（除非后面换了远程仓库）
# 验证关联：git remote -v
git remote add origin git@github.com:帐号名/仓库名.git  # 关联远程仓库，仅在第一次时关联即可
git push -u origin master                  # 同步远程仓库，origin是仓库别名，master是分支

绑定本地代码库和远程仓库有两种方式：

【方法一：在平台上创建完仓库后，clone到本地】

git clone <远程代码仓库地址>    # 把远程 Git 仓库克隆到本地

【方法二：在平台上创建仓库，也在本地创建仓库，再进行绑定】

git init                                # 创建本地代码仓库
git remote add <远程代码仓库地址>        # 绑定本地仓库与远程仓库

注意1：首次执行commit命令时可能遇到下面报错

这是因为Git会要求配置一个身份标识，使用下面代码进行配置

git config –global user.name  "用户名"      # 设置用户名
git config –global user.email "用户邮箱"    # 设置邮箱

注意2：执行push命令时可能遇到下面报错：

这是因为远程仓库需要登录并校验权限，常用校验方式有两种：

【方法一：HTTPS地址 + 账号密码】

该方法简单但安全性较差，GitHub在2021年停用账号密码认证，而是需要用户名+PAT令牌

申请PAT（Personal access token）令牌步骤：

Settings → Developer settings → Personal access tokens → Fine-grained tokens → Generate new token

【方法二：SSH链接 + 密钥】

在绑定远程仓库时，不要用HTTPS链接，而是使用SSH链接

在本地打开Git Bash，输入命令：ssh-keygen -t rsa -C 邮箱
后续看到 : 就按回车，看到 yes or no 就按 y ，再按回车

找到public key存放的地址，打开 id_rsa.pub 后复制

在GitHub上进行设置：Settings → SSH and GPG keys → New SSH key→ 把刚刚复制的内容粘贴到key处

这样就成功了，至此，生成密钥的这台电脑已经与GitHub账号进行了绑定，后续在这台电脑上只要通过SSH链接，就不需要再校验权限

【常用git命令】

中文	英文	完整命令示例	说明
克隆	`Clone`	`git clone <仓库地址>`	克隆远程仓库到本地。
拉取	`Pull`	`git pull origin <分支名>`	拉取远程分支并合并到当前分支。
获取	`Fetch`	`git fetch origin`	获取远程仓库的最新信息，但不合并。
推送	`Push`	`git push origin <分支名>`	将本地分支推送到远程仓库。
同步	`Sync`	`git fetch origin && git merge origin/<分支名>`	获取远程分支并合并到当前分支。
提交	`Commit`	`git commit -m "提交信息"`	提交更改到本地仓库。
添加	`Add`	`git add <文件名>` 或 `git add .`	将文件添加到暂存区。
状态	`Status`	`git status`	查看当前仓库的状态。
分支	`Branch`	`git branch <分支名>`	创建新分支。
切换	`Checkout`	`git checkout <分支名>`	切换到指定分支。
合并	`Merge`	`git merge <分支名>`	将指定分支合并到当前分支。
重置	`Reset`	`git reset <选项> <提交哈希>`	重置当前分支到指定提交。
日志	`Log`	`git log`	查看提交历史。
标签	`Tag`	`git tag <标签名>`	为当前提交创建标签。
差异	`Diff`	`git diff`	查看工作区与暂存区的差异。
远程	`Remote`	`git remote add origin <仓库地址>`	添加远程仓库。
删除	`Remove`	`git rm <文件名>`	从工作区和暂存区删除文件。
移动	`Move`	`git mv <旧文件名> <新文件名>`	移动或重命名文件。
储藏	`Stash`	`git stash`	暂存当前工作目录的更改。
恢复	`Restore`	`git restore <文件名>`	恢复工作区文件到指定状态。
清理	`Clean`	`git clean -f`	删除未跟踪的文件。

『教程』简单明了的Git入门_哔哩哔哩_bilibili

非常好的教程：人人都能看懂的Git教程！Git如何和 GitHub、GitLab 交互？团队如何用 Git 协作开发？小白也能看懂的Git教程！_哔哩哔哩_bilibili

【克隆目标仓库】

git clone git_url                # 克隆默认分支（通常是 main 或 master）
git clone --recursive git_url    # 递归克隆该仓库默认分支及其所有子模块

示例：esp32-board: esp32开发板配套的经典例程

git clone --recursive https://gitee.com/vi-iot/esp32-board.git

GitHub官方文档：克隆仓库 - GitHub Enterprise Cloud Docs

【Git团队开发的一种流程】

【Git客户端TortoiseGit】

若习惯了可视化界面的操作，可使用Git客户端：https://tortoisegit.org/download/

详细教程：Git客户端(TortoiseGit)使用详解-CSDN博客
git及github、gitee学习 - 始终不够啊 - 博客园

参考：git、gitee、github关系梳理及ssh不对称加密大白话解释_git与gitee的关系-CSDN博客
版本控制系统git和svn - 兵临城下的匹夫 - 博客园
Git基本原理介绍(1)——代码仓库的初始化_哔哩哔哩_bilibili
如何在 Git 上传代码：小白必读，非常全面-腾讯云开发者社区-腾讯云
Gitea: Git with a cup of tea
7分钟教会你如何Git文件到仓库！没有废话！_哔哩哔哩_bilibili
https://zhuanlan.zhihu.com/p/639102098

版本回退：使用TortoiseGit进行版本的回滚_tortoisegit回滚版本-CSDN博客

【下载、克隆和分支之间的区别】

【下载GitHub中的子文件夹】

想要下载GitHub上某一仓库的全部内容很简单，官方提供了下载按钮

但是如果仅仅想下载仓库中的个别文件，就很棘手，我们可以通过下面网站进行复制下载（注意Google浏览器可能会进行拦截，推荐使用Edge）：DownGit

比如我想下载https://github.com/espressif/esp-idf/tree/master下的ble50_security_client目录下的文件

复制URL：https://github.com/espressif/esp-idf/tree/master

通过点击Copy path得到：examples/bluetooth/bluedroid/ble_50/ble50_security_client

两者拼接得到新的URL，把该URL粘贴到DownGit，点击Download即可成功下载

https://github.com/espressif/esp-idf/tree/master/examples/bluetooth/bluedroid/ble_50/ble50_security_client

参考：下载GitHub项目两种方法-CSDN博客
下载Github中的子文件夹两种方法 - 哔哩哔哩

【不用魔法的访问方法】

加速器一：网易UU加速器——不止快，还很稳。用UU云存档，给存档上个保险。

加速器二：Steam++：Watt Toolkit

具体使用方法见视频：『教程』手把手教你流畅访问Github_哔哩哔哩_bilibili

【GitHub官方文档】

仓库快速入门 - GitHub Enterprise Cloud Docs

个人记录：

HTTP：http://lXXXc_nas:12080/zhangXXX/Gateway_WiFi.git
SSH：ssh://git@lXXXc_nas:12022/zhangXXX/Gateway_WiFi.git# 从命令行创建一个新的仓库
touch README.md     # 可选，Markdown 格式的工程说明
git init            # 在当前目录初始化一个本地 Git 仓库，执行后会生成隐藏的 .git 文件夹，用于存储版本控制信息，只有执行此命令后，才能在该目录中使用 git add、git commit 等操作git add .           # 把所有文件放入 Git 暂存区（Staging Area）
git commit -m "first commit"    # 将暂存区的文件提交到本地仓库，并添加提交说明。-m 参数用于直接附加提交信息（必须填写，否则会进入编辑器界面），交信息应简洁明确（例如：“修复登录功能BUG”）
git remote add origin http://lXXXc_nas:12080/zhangXXX/Gateway_WiFi.git    # 将远程仓库的 URL 关联到本地仓库，并命名为 origin，origin 是远程仓库的默认别名（可自定义，但一般用 origin），URL 来自 Gitea 仓库页面的 克隆地址（HTTP 或 SSH），验证关联：git remote -v
# git remote add origin ssh://git@lXXXc_nas:12022/zhangXXX/Gateway_WiFi.git
git push -u origin master    # 将本地仓库的代码推送到远程仓库，-u 参数会将本地 master 分支与远程 origin/master 分支绑定，后续可直接用 git push，master 是默认分支名称（部分平台已改用 main，需根据实际分支名调整），首次推送可能需要输入 Gitea 账号密码# 从命令行推送已经创建的仓库
git remote add origin http://lXXXc_nas:12080/zhangXXX/Gateway_WiFi.git
# git remote add origin ssh://git@lXXXc_nas:12022/zhangXXX/Gateway_WiFi.git
git push -u origin master

【版本控制系统】

【Git概述】

【Git下载】

【Git初始化本地仓库并推送】

【克隆目标仓库】

【Git团队开发的一种流程】

【Git客户端TortoiseGit】

【下载、克隆和分支之间的区别】

【下载GitHub中的子文件夹】

【不用魔法的访问方法】

【GitHub官方文档】

相关文章：