跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
编程语言大前端

Git 版本控制入门及 Gitee 远程仓库协作指南

Git 版本控制系统入门及 Gitee 远程仓库协作指南。内容涵盖 Git 安装配置、本地工作区与暂存区概念、分支管理策略、SSH 公钥配置及远程仓库同步操作。通过实际场景演示代码推送、拉取、合并流程,并提供历史版本查看与回退方法,帮助开发者掌握代码版本控制核心技能。

咸鱼开飞机发布于 2026/3/28更新于 2026/10/2587 浏览

Git & Gitee 基础教程

Gitee 简介

Gitee(码云)是开源中国推出的本土化 Git 代码托管与研发协作平台,核心提供代码存储、版本控制、团队协同开发功能,还支持项目管理、CI/CD 流水线、静态网站部署等能力。

第一章:初识 Git - 安装与配置

1. 什么是 Git?

Git 是一个分布式版本控制系统。可以把它想象成一个能记录你每一次代码修改的'时光机'。你可以随时回到过去的任何一个版本,也可以放心地开辟一个新的'平行时空'(分支)去尝试新功能,而不用担心会搞乱主线代码。

2. Gitee 又是什么?

如果说 Git 是管理你本地代码的'时光机',那么 Gitee(或者 GitHub)就是一个远程代码仓库,一个云端的'代码银行'。你可以把本地的代码'存款'(推送)到 Gitee 上,方便备份,也方便和团队成员共享、协作。

3. 首次使用:全局配置

在开始使用 Git 之前,你需要先'自报家门',告诉 Git 你是谁。这样,在未来的每一次提交中,Git 都会记录下你的大名。

打开你的终端(在 Windows 上可以是 Git Bash),输入以下命令:

# 配置你的用户名
git config --global user.name "你的用户名"
# 配置你的邮箱地址
git config --global user.email "你的邮箱地址"

提示:这里的用户名和邮箱只是一个标识,你可以使用你的 Gitee 或 GitHub 账户信息,也可以自定义。

配置完成后,你可以使用以下命令来查看所有配置信息:

git config --list

第二章:Git 核心操作 - 你的第一个本地仓库

1. 三个区域的概念

要理解 Git,必须先了解它的三个核心区域:

  • 工作区 (Working Directory):就是你在电脑上能看到的项目文件夹,你直接修改代码的地方。
  • 暂存区 (Staging Area):一个临时的存储区域,用于存放你'打算'提交的修改。
  • 版本库 (Repository):存放了项目所有历史版本的地方,也就是你的'时光机'本体。

文章配图

2. 创建你的代码仓库

首先,在你电脑上创建一个新的文件夹(或者进入一个已有的项目文件夹),然后执行:

git init

这个命令会在当前目录下创建一个 .git 的隐藏文件夹,标志着你的本地 Git 仓库初始化成功!

3. 工作流:修改、添加、提交

这是 Git 最核心、最常用的操作流程。

第一步:检查状态
使用 git status 命令,它可以告诉你当前仓库的状态。

git status
  • 红色文件名:表示文件在工作区被修改了,但还没有被添加到暂存区。
  • 绿色文件名:表示文件已经被添加到暂存区,等待被提交。
  • nothing to commit, working tree clean:表示你的工作区、暂存区和版本库是完全同步的,没有任何改动。
  • 第二步:添加到暂存区
    当你完成了一个小阶段的修改后,需要把这些改动从工作区'登记'到暂存区。

    # 添加所有已修改的文件到暂存区
    git add .
    

    提示:.代表当前目录下的所有改动。你也可以指定单个文件,如 git add index.html。

    第三步:提交到版本库
    将暂存区的所有内容正式'存盘',形成一个新的历史版本。

    git commit -m "这里写本次提交的说明信息"
    

    强烈建议:-m 后面的提交信息一定要写得清晰明了,比如'修复了登录页面的 bug'、'增加了用户注册功能'。这将有助于你日后回顾查看!

    第三章:团队协作 - 分支管理

    分支是 Git 的'杀手级'功能!它允许你创建一个主线(通常是 master 或 main)的副本,在这个副本上随心所欲地开发新功能,完成后再安全地合并回主线。

    1. 分支常用命令
    操作命令说明
    查看分支git branch列出所有本地分支,当前分支前会有一个 * 号
    创建分支git branch <新分支名>基于当前分支创建一个新的分支
    切换分支git checkout <分支名>切换到指定的分支去工作
    创建并切换git checkout -b <新分支名>一步完成创建和切换两个操作,强烈推荐!
    合并分支git merge <要合并过来的分支名>将指定分支的修改合并到当前所在的分支
    删除分支git branch -d <分支名>删除一个已经合并过的分支
    强制删除git branch -D <分支名>强制删除一个未合并的分支(请谨慎操作)
    重命名分支git branch -m <老分支名> <新分支名>
    2. 实际应用场景

    假设你正在 master 分支上,突然需要开发一个新功能(比如'用户评价')。

    1. git checkout -b feature-comment // 创建并切换到一个名为 feature-comment 的新分支
    2. 在这个新分支上,编写你的代码,不断地 add 和 commit。
    3. 功能开发完成并通过测试后,切换回主分支:git checkout master。
    4. 将新功能分支合并进来:git merge feature-comment。
    5. 删除已经完成使命的分支:git branch -d feature-comment。

    第四章:连接世界 - Gitee 远程仓库

    现在,是时候将你的本地仓库和云端的 Gitee 连接起来了。

    1. 配置 SSH 公钥(一劳永逸)

    为了让你每次推送代码时不用反复输入用户名和密码,我们推荐配置 SSH 公钥。这就像是给你的本地电脑办了一张 Gitee 的'通行证'。

    1. 配置到 Gitee:
      登录 Gitee,在右上角头像处点击'设置' -> '安全设置' -> 'SSH 公钥',将你复制的公钥粘贴进去,标题可以随便写,然后点击'确定'。

    测试连接:

    ssh -T [email protected]
    

    如果看到 Hi [你的用户名]! You've successfully authenticated...,就说明配置成功了!

    查看并复制公钥:

    cat ~/.ssh/id_ed25519.pub
    

    将输出的一长串以 ssh- 开头的内容完整复制下来。

    生成 SSH 公钥:

    # -C 后面可以是任意名字,通常用邮箱
    ssh-keygen -t ed25519 -C "[email protected]"
    

    执行后一路回车即可。

    2. 核心远程操作
    操作命令说明
    关联远程仓库git remote add origin <远程仓库地址>将本地仓库与一个远程仓库地址关联起来,origin 是远程仓库的默认别名
    克隆仓库git clone <远程仓库地址>从远程地址完整地复制一个项目到本地
    推送代码git push -u origin <分支名>首次将本地分支的提交推送到远程仓库
    git push后续推送,简化命令
    拉取代码git pull从远程仓库拉取最新的代码并与本地代码合并,每次写代码前和提交代码前都应执行
    删除远程关联git remote remove origin解除本地与远程仓库的关联
    3. 两种协作模式
    • 模式一:从零开始,推送本地项目
      1. 在 Gitee 上创建一个空的新仓库。
      2. 在本地项目目录中,执行 git init, git add ., git commit ...
      3. git remote add origin [你的 Gitee 仓库 SSH 地址]
      4. git push -u origin master
    • 模式二:加入已有项目,克隆远程项目
      1. 找到项目的 Gitee 仓库地址。
      2. git clone [Gitee 仓库 SSH 地址]
      3. cd [项目文件夹]
      4. 开始你的开发,然后使用 git add, git commit, git push 即可。

    第五章:Git - 版本回退与历史查看

    1. 查看历史
    • git log: 查看详细的、完整的提交历史(提交者、日期、说明等)。
    • git log --oneline: 以一行的形式展示精简的历史信息。
    • git reflog: 查看你的所有操作记录,包括已经删除的 commit 和版本回退操作。这是你的'终极后悔药'!
    2. 版本回退

    当你发现某个版本改错了,想回到过去时,就需要版本回退。

    # 版本号就是通过 git log 或 git reflog 看到的哈希值(如:ede7b8e)
    git reset --hard <版本号>
    

    ⚠️ 警告:--hard 参数会彻底丢弃你当前工作区和暂存区的所有改动,直接回到指定的版本。这是一个危险操作,执行前请务必确认你没有未保存的重要代码!

    目录

    1. Git & Gitee 基础教程
    2. Gitee 简介
    3. 第一章:初识 Git - 安装与配置
    4. 1. 什么是 Git?
    5. 2. Gitee 又是什么?
    6. 3. 首次使用:全局配置
    7. 配置你的用户名
    8. 配置你的邮箱地址
    9. 第二章:Git 核心操作 - 你的第一个本地仓库
    10. 1. 三个区域的概念
    11. 2. 创建你的代码仓库
    12. 3. 工作流:修改、添加、提交
    13. 添加所有已修改的文件到暂存区
    14. 第三章:团队协作 - 分支管理
    15. 1. 分支常用命令
    16. 2. 实际应用场景
    17. 第四章:连接世界 - Gitee 远程仓库
    18. 1. 配置 SSH 公钥(一劳永逸)
    19. -C 后面可以是任意名字,通常用邮箱
    20. 2. 核心远程操作
    21. 3. 两种协作模式
    22. 第五章:Git - 版本回退与历史查看
    23. 1. 查看历史
    24. 2. 版本回退
    25. 版本号就是通过 git log 或 git reflog 看到的哈希值(如:ede7b8e)

    更多推荐文章

    查看全部
    • 网络安全工程师面试真题汇总:Web 安全、内网渗透与系统加固
    • 双指针算法核心概念与 C++ 经典例题解析
    • 本地搭建 Stable Diffusion AI 绘画工具完整指南
    • Python + Neo4j 构建知识图谱实战指南
    • MS-S1 MAX (AI MAX 395) 在 Ubuntu 24.04 利用 Vulkan llama.cpp 运行 gpt-oss 120b
    • 用 Python 搞自动化:爬简历、整文件、盯价格的几个实用脚本
    • AMDGPU 驱动架构概览
    • Android System WebView 版本对照与内核更新指南
    • 使用 Figma-MCP 与 Claude Code 实现 UI 1:1 还原
    • 无人机基本组成与结构设计
    • OpenClaw 对接 QQ 机器人教程(本地与腾讯云部署)
    • Python 兼职接单指南:需求评估与平台选择
    • OpenClaw 部署指南:Linux 环境搭建与模型/飞书集成
    • llama.cpp 本地部署常见故障排查与优化方案
    • 零基础 Python 爬虫学习指南:安装、应用方向与就业薪资
    • RxJava 迁移至 Kotlin Flow 的背压策略对比与实现
    • 沃研 Turbo 科研大模型发布:支持论文推荐、降重与润色
    • PX4 无人机 MID360 激光雷达 FAST-LIO 室内定位与定点悬停配置
    • OpenClaw 实战:基于 Rust+Tauri 构建安全沙箱清理 Skill
    • Linux 系统文件 IO 与重定向原理

    相关免费在线工具

    • Base64 字符串编码/解码

      将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

    • Base64 文件转换器

      将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

    • Markdown转HTML

      将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online

    • HTML转Markdown

      将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online

    • JSON 压缩

      通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online

    • JSON美化和格式化

      将JSON字符串修饰为友好的可读格式。 在线工具,JSON美化和格式化在线工具,online