一. 什么是Gitee
- 基于Git的代码托管和研发协作平台
- 上面可以托管个人或者公司的代码和开源项目
- 国外有Github,国内有Gitee
- Github经常出现无法访问的问题,推荐使用Gitee
Git 是一种分布式版本控制系统,用于管理软件项目的源代码。它是由 Linux 之父 Linus Torvalds 开发的,并已经成为了现代软件开发领域中最流行的版本控制系统之一。
使用 Git 可以追踪代码的历史修改记录,方便团队协作、代码共享和代码重构。Git 的基本工作流程如下:
- 1.在开始编写代码之前,首先需要创建一个 Git 仓库(repository),用于存储代码和版本历史记录。
- 2.在编写代码时,可以通过 git add 命令将更改的文件添加到 Git 的暂存区(staging area)中。
- 3.通过 git commit 命令将暂存区中的更改提交到 Git 仓库中,并生成一个新的版本号(commit hash)。
- 4.如果需要撤销某个提交,可以使用 git revert命令来创建一个新的提交,该提交将会抵消先前的提交效果。
- 5.如果需要合并不同分支的代码,可以使用 git merge 命令进行合并。
- 6.如果需要查看代码的历史提交记录,可以使用 git log 命令来获取详细信息。
- 7.如果需要将代码推送到远程仓库,可以使用 git push命令将本地代码推送到远程仓库
- 8.如果需要从远程仓库中获取代码,可以使用 git pull 命令将远程代码拉取到本地
每一段的代码改动,Git都会记录下来,如果出现问题,或者想要查看之前的版本,Git可以找到任意节点的代码状态。
二. 在Gitee上创建远程仓库
- 填写仓库信息
初始化仓库(设置语言、.gitignore、开源许可证)
勾选后,创建仓库时自动生成基础文件:
.gitignore:配置 git 忽略文件,比如 IDE 缓存、编译产物,不会上传到仓库- 可以选择编程语言模板、开源协议(MIT 等)
如果你打算本地用
git clone拉取仓库,新手建议不勾选,避免本地和远程仓库初始化冲突。
设置模板(添加 Readme、Issue、Pull Request 模板文件)勾选会自动生成:
README.md:仓库介绍文档(项目说明)- Issue 模板、PR 模板:多人协作时,别人提 bug / 合并代码会自动套用规范表单
选择分支模型(仓库创建后将根据所选模型创建分支)
用来预设分支管理规范,例如 GitFlow 等分支模型,自动创建main/dev等分支,适合团队协作项目;个人学习一般不用勾选。
3. 进入这个页面表示创建成功
三. 将远程仓库clone到本地
- 在想要clone的文件夹右键,点击clone
并输入仓库的地址。
clone成功会出现一个文件夹:
里面有一个默认不可见的.git文件,表示已经与远程仓库建立联系。
四. 提交代码三板斧-基础操作
- add - 将代码添加至本地仓库
- commit - 提交代码至本地仓库
- push - 推送本次添加至远程仓库
参考此部分:
- Workspace:工作区
- Index / Stage:暂存区
- Repository:仓库区(或本地仓库)
- Remote:远程仓库
具体实现
1.这里我在上面clone的项目文件里面添加了新东西。
点击如下操作,完成add操作。
2.这部分是选择需要提交的文件。默认是全部文件
3.接着完成第二步,commit
写代码改动的注释:
4.完成第三步,完成push
勾选Set upstream/track remote branch
直接点底部OK
第一次登录会出现
输入即可:
最后出现success的时候证明成功了:
此时进入仓库,即可看到之前添加的文件:
五. 提交遇到的问题
这部分可以参考b站教程:
https://www.bilibili.com/video/BV1hf4y1W7yT/?spm_id_from=333.788.player.switch&vd_source=630345033ef087ca76dda824848f89f6&p=7
六. tortoiseGit的高频常用功能
显示日志 Show log
- 作用:查看全部提交历史,每一次提交、提交人、时间、改动文件。
- 用法:打开日志窗口,双击任意提交,就能看这次提交改了哪些代码;按住
Ctrl选中两个提交,可以对比两个版本之间全部差异。 - 用途:追溯代码、找历史版本、回退版本都从这里操作。
差异比较 Diff
- 作用:看当前本地文件和 上一次提交版本 的对比,高亮标出新增 / 删除 / 修改行。
- 适合:改完代码,先检查一遍自己改了什么,再 commit。
回退 revert:
丢弃还没 commit的本地修改
- 场景:本地改乱了,想放弃本次所有未提交改动,回到上次提交干净状态
- 操作:TortoiseGit → Revert,勾选要撤销的文件,OK。本地改动直接删掉,小心
撤回added状态的文件:
回退到上一版本
选择show log 进入后选择Reset “master” to this commit
然后有:
- Mixed(⭐推荐默认,新手首选)
分支指针回到旧版本,代码改动保留在本地文件。你可以检查文件,满意再重新 commit;不满意直接丢弃。安全,不会丢代码。 - Soft:指针回退,改动保留在暂存区(相当于已经 add 完,直接就能 commit)
- Hard ⚠️极度危险!
直接删掉这个版本之后所有提交,本地文件强制变成旧版本,后面新写的代码直接消失,无法恢复!非紧急不要用。
这里是mixed,也就是本地的状态是上一个状态,文件还在本地,但是可以改动,然后add。
六. 提交本地文件至远程仓库
第 1 步:Gitee 网页端新建仓库
第 2 步:在你本地项目文件夹,初始化 Git 仓库
进入本地文件夹
空白处右键→ TortoiseGit →Create repository here(在此创建仓库)
直接点 OK。
第 3 步:添加远程仓库(把本地仓库绑定 Gitee 远程地址)
右键文件夹 → TortoiseGit →Settings 设置
左侧找到Remote
- 点 Add,名字填:
origin(固定名字,约定俗成) - URL 粘贴你复制的 Gitee 仓库 HTTPS 地址
点 OK 保存。
这句话意思:是否拉取远程仓库的分支。
咱们 Gitee 上这个仓库是空仓库,没有任何分支,fetch 拿不到东西,选否就行。
第4步:建立联系后,即可正常推送
记住:
✅勾选 Set upstream/track remote branch(第一次必须勾选,建立追踪)
点 OK,推送完成。
七. 删除仓库
- 找到对应要删除的仓库,并点击“管理”;
- 点击删除仓库,并按照指示操作即可;
八. 库的结构
这些是工程 / 仓库基础文件,不是业务代码;新建开源仓库一般都会创建:
your-project/
├─ .gitignore # git忽略文件:告诉git哪些文件不要提交(编译产物、日志、本地配置、node_modules等)
├─ LICENSE # 开源许可证,定义别人怎么用你的代码,开源项目必备
├─ README.md # 项目介绍:作用、快速上手、安装、示例(几乎所有开源项目都写)
└─ .gitattributes # 可选但很常用:控制git识别文本/二进制文件、换行符