跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Shell / Bash大前端

Git 与 Gitee 协作开发指南

Git 版本控制系统的核心概念及 Gitee 代码托管平台的搭建流程。内容涵盖环境安装、本地仓库初始化、远程仓库关联、分支管理及团队协作实战。通过详细命令示例和常见问题解答，帮助开发者掌握从入门到实战的完整工作流，实现高效的代码版本管理与多人协作。

Ne0发布于 2026/3/24更新于 2026/5/2229 浏览
Git 与 Gitee 协作开发指南

Git 与 Gitee 简介

Git 是一个免费、开源、分布式的版本控制系统，用于高效记录代码变更、管理版本历史、支持多人协作开发。

Gitee（码云）是国内基于 Git 的代码托管平台，提供仓库管理、代码协作、CI/CD 等功能，是团队协作开发的常用工具。

Gitee 平台示例

什么是 Git？

Git 用于本地代码管理。官方文档：Git - Reference

什么是 Gitee？

Gitee 提供云端代码托管。官网：https://gitee.com/

环境搭建

安装 Git

  • Windows：下载 Git for Windows 安装
  • macOS：使用 Homebrew：brew install git
  • Linux：使用包管理器安装，如 sudo apt install git

检查安装

打开终端输入：

git --version

出现版本号即安装成功。

检查版本

配置用户信息

设置全局用户名和邮箱（用于提交记录）：

git config --global user.name "你的用户名"
git config --global user.email "你的邮箱"

Git 基础操作（本地仓库）

初始化仓库

git init

该命令会在当前目录创建 .git 文件夹，表示这是一个 Git 仓库。

初始化仓库

.git 文件夹

添加文件到暂存区

git add 文件名 # 添加单个文件
git add .      # 添加所有文件

提交到本地仓库

git commit -m "提交说明"

查看状态与日志

git status       # 查看文件状态
git log --oneline # 查看简洁提交历史

git status 根据颜色判断文件的状态：红色为工作区；绿色为暂存区；没有颜色为版本库。

版本回退

git reset --hard 版本号 # 回退到指定版本

Gitee 平台使用

Gitee 界面

Git 与 Gitee 的关系详解

核心关系：工具 vs 平台
GitGitee
性质版本控制系统工具基于 Git 的代码托管平台
位置安装在你的电脑本地部署在云端的服务器
功能管理代码版本的工具存储代码的云端仓库

本地仓库：你电脑上的 .git 文件夹，由 Git 管理。 远程仓库：在 Gitee 服务器上的仓库，用于团队共享和备份。

两者如何协同工作
开发者 A 的电脑 -> Gitee 服务器 -> 开发者 B 的电脑
↓                ↓               ↓
本地 Git 仓库 ←推送/拉取→ 远程仓库 (主仓库) ←推送/拉取→ 本地 Git 仓库

流程简述：

  1. git init 创建仓库
  2. git clone (通过网站)
  3. git add . / git pull
  4. git commit / git add .
  5. git push / git commit
  6. ... / git push
注册与登录

访问 gitee.com 注册账号并登录。

创建仓库

点击右上角 + → 新建仓库，输入仓库名称、描述，选择公开/私有，初始化选项可选（README、.gitignore、许可证），点击 创建。

创建仓库 仓库设置

配置 SSH 公钥（推荐）

避免每次推送都要输入密码：

ssh-keygen -t rsa -C "你的邮箱"

此命令生成一套 SSH 密钥对（包含私钥和公钥）。Git 借助这对密钥，和 Gitee 这类远程仓库做安全连接，完成身份验证。

在 ~/.ssh/id_rsa.pub 文件中复制公钥，添加到 Gitee → 设置 → SSH 公钥。

系统默认路径说明
WindowsC:\Users\你的用户名\.ssh\id_rsa.pub（或 id_ed25519.pub）需替换'你的用户名'，.ssh 是隐藏文件夹
macOS/Users/你的用户名/.ssh/id_rsa.pub（或 id_ed25519.pub）~ 代表当前用户主目录
Linux/home/你的用户名/.ssh/id_rsa.pub（或 id_ed25519.pub）~ 代表当前用户主目录

本地仓库与 Gitee 关联

将代码提交到远程仓库 Gitee。

关联远程仓库

git remote add origin [email protected]:用户名/仓库名.git

首次推送

git push -u origin master

-u 说明已经对当前的 master 分支进行了跟踪，下次从本地 master 推到远程，直接 git push 就可以了。

克隆仓库到本地

git clone [email protected]:用户名/仓库名.git

日常开发流程（单人）

拉取最新代码（开始工作前）

git pull origin master

修改代码后提交

git add .
git commit -m "完成某某功能"
git push origin master

分支管理

创建与切换分支

git branch 分支名           # 创建分支
git checkout 分支名         # 切换分支
# 或使用一条命令：
git checkout -b 分支名

查看分支

git branch          # 查看本地分支
git branch -r       # 查看远程分支
git branch -a       # 查看所有分支

合并分支

git checkout master   # 切换到主分支
git merge 分支名      # 合并某分支到当前分支

删除分支

git branch -d 分支名            # 删除本地分支
git push origin --delete 分支名 # 删除远程分支

团队协作实战

多人协作流程

  1. 克隆远程仓库：git clone
  2. 创建自己的分支：git checkout -b feature-xxx
  3. 开发并提交到自己的分支
  4. 推送到远程：git push origin feature-xxx
  5. 在 Gitee 提交 Pull Request (PR)
  6. 团队成员审核代码合并到主分支

处理冲突

当多人修改同一文件时可能出现冲突：

  1. 拉取最新代码： 
    git pull origin master
  2. 手动解决冲突文件（文件中会标注冲突内容）
  3. 重新提交： 
    git add .
git commit -m "解决冲突"
git push origin 分支名

使用 .gitignore

创建 .gitignore 文件，列出不需要提交的文件——这样这些文件就不会被提交到本地仓库和云端仓库，如：

node_modules/
*.log
.DS_Store

实战练习建议

  1. 练习 1：在 Gitee 创建个人项目，完成本地初始化、添加文件、提交推送。
  2. 练习 2：创建 dev 分支，开发一个简单功能，合并到 master。
  3. 练习 3：模拟团队协作，邀请伙伴共同开发一个项目，练习 PR 和代码审查流程。

常见问题

  • Q：push 被拒绝？ A：先执行 git pull --rebase origin master 拉取最新代码再推送。
  • Q：如何查看远程地址？ A：git remote -v
  • Q：提交信息写错了怎么办？ A：git commit --amend 修改最近一次提交信息。

附录：常用命令速查表

分类指令说明
初始化与配置git init在当前目录初始化新 Git 仓库（创建 .git 文件夹）
git config --global user.name "Name"配置全局用户名（提交时显示）
git config --global user.email "Email"配置全局邮箱（提交时显示）
git config --list查看当前 Git 配置（全局 + 本地仓库）
工作区操作git status查看工作区文件状态（未暂存/已暂存的新增、修改、删除）
git diff比较工作区（未暂存）与暂存区的文件差异（显示具体修改内容）
git diff --cached比较暂存区与本地仓库（最近一次提交）的文件差异
git diff比较当前分支与指定分支的差异
暂存区操作git add将指定文件从工作区添加到暂存区（准备提交）
git add . / git add -A将工作区所有修改（新增、修改、删除）添加到暂存区
git rm --cached将文件从暂存区移除（保留工作区文件，仅取消暂存）
git rm删除工作区文件，并将'删除操作'添加到暂存区（彻底删除）
本地仓库操作git commit -m "message"将暂存区内容提交到本地仓库（-m 后跟提交说明）
git commit --amend修改最近一次提交（补充说明或修正暂存区内容，不新增记录）
git log查看本地提交历史（按时间倒序，显示提交者、时间、说明等）
git log --oneline简洁显示提交历史（仅显示提交 ID 前 7 位和说明）
git log --graph --pretty=oneline --abbrev-commit图形化显示分支合并历史
git reflog查看所有操作记录（包括被删除的提交，用于找回误删内容）
分支操作git branch查看本地所有分支（当前分支前有 * 标记）
git branch创建新分支（基于当前分支最新提交）
git checkout / git switch切换到指定分支（switch 为 Git 2.23+ 新增，更直观）
git checkout -b / git switch -c创建并切换到新分支（等价于 git branch + git checkout）
git merge将指定分支内容合并到当前分支（需先切换到目标分支）
git branch -d删除已合并到当前分支的本地分支（未合并会报错）
git branch -D强制删除本地分支（无论是否合并）
git branch -r查看远程仓库分支
git branch -a查看本地和远程所有分支
远程仓库操作git clone克隆远程仓库到本地（自动关联远程）
git remote add关联本地仓库与远程仓库（通常 remote-name 为 origin）
git remote查看已关联的远程仓库名称（默认 origin）
git remote -v查看远程仓库详细地址（fetch/push 地址）
git pull拉取远程分支更新并合并到当前本地分支（等价于 git fetch + git merge）
git push将本地分支提交推送到远程仓库对应分支
git push -u推送并关联本地与远程分支（后续可直接 git push）
git push --delete删除远程仓库指定分支
git fetch拉取远程仓库所有更新（不合并，需手动 merge）
标签操作git tag为当前提交创建轻量标签（仅标记，无说明）
git tag -a -m "message"创建带说明的附注标签（推荐，包含更多信息）
git tag给指定历史提交打标签（commit-id 可通过 git log 获取）
git tag查看本地所有标签
git show查看指定标签的详细信息（对应提交内容、作者、时间）
git push将指定标签推送到远程仓库
git push --tags将本地所有标签推送到远程仓库
git tag -d删除本地标签
git push --delete删除远程仓库指定标签
撤销与回滚git checkout -- / git restore放弃工作区修改（恢复到暂存区/本地仓库状态）
git reset HEAD / git restore --staged将暂存区文件回滚到工作区（取消暂存）
git reset --hard回滚到指定提交（会丢弃工作区和暂存区修改，谨慎使用）
git cherry-pick将指定提交内容应用到当前分支（跨分支复用提交）
其他常用操作.gitignore 文件配置无需版本控制的文件（如 node_modules/、*.log）
git check-ignore -v检查文件是否被 .gitignore 忽略（排查配置问题）
git stash暂存工作区修改（临时保存未提交内容，用于切换分支等场景）
git stash list查看所有暂存的 stash 列表
git stash pop恢复最近一次 stash 内容，并删除该 stash
git stash apply恢复指定 stash 内容（保留 stash，stash-id 从 list 获取）
git stash drop删除指定 stash
git stash clear清空所有 stash

目录

  1. Git 与 Gitee 简介
  2. 什么是 Git？
  3. 什么是 Gitee？
  4. 环境搭建
  5. 安装 Git
  6. 检查安装
  7. 配置用户信息
  8. Git 基础操作（本地仓库）
  9. 初始化仓库
  10. 添加文件到暂存区
  11. 提交到本地仓库
  12. 查看状态与日志
  13. 版本回退
  14. Gitee 平台使用
  15. Git 与 Gitee 的关系详解
  16. 核心关系：工具 vs 平台
  17. 两者如何协同工作
  18. 注册与登录
  19. 创建仓库
  20. 配置 SSH 公钥（推荐）
  21. 本地仓库与 Gitee 关联
  22. 关联远程仓库
  23. 首次推送
  24. 克隆仓库到本地
  25. 日常开发流程（单人）
  26. 拉取最新代码（开始工作前）
  27. 修改代码后提交
  28. 分支管理
  29. 创建与切换分支
  30. 或使用一条命令：
  31. 查看分支
  32. 合并分支
  33. 删除分支
  34. 团队协作实战
  35. 多人协作流程
  36. 处理冲突
  37. 使用 .gitignore
  38. 实战练习建议
  39. 常见问题
  40. 附录：常用命令速查表
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫，关注极客日志

微信公众号「极客日志V2」，在微信中扫描左侧二维码关注。展示文案：极客日志V2 zeeklog

更多推荐文章

查看全部
  • Windows 系统部署 RabbitMQ 及 Erlang 环境配置指南
  • Vue3 方法调用报错“不存在”？通常是 setup 作用域问题
  • 腾讯云开发 Copilot 低代码开发体验与技术分析
  • 时间序列预测中如何构建层级化的 Transformer 架构
  • 5 款主流 AI 编程工具深度评测与选型指南
  • Git 安装配置及 IntelliJ IDEA 集成使用指南
  • TikTok 数据抓取教程：Python 工具快速入门
  • 苍穹外卖实战：Spring Task 定时任务与 WebSocket 实时通信
  • MacOS 部署 OpenClaw 并集成飞书实现 AI 自动化
  • Excel 转 CSV 并导入 MySQL 的操作指南
  • Python 办公自动化入门：常用文档与数据处理技巧
  • iOS 26 Liquid Glass TabBar 实现与优化实战
  • JVM 对象引用定位机制：句柄池与直接指针
  • 多模态大模型原理与跨模态应用实战
  • 前后端分离机动车号牌管理系统：基于 SpringBoot、Vue 与 MyBatis
  • Stable Diffusion 显存优化方案：解决内存不足错误
  • Python OCR 文字识别：pytesseract 安装配置与使用
  • 分治算法实战：归并排序与逆序对问题
  • 使用 GitHub Copilot 和 Figma MCP 还原设计稿生成前端代码
  • Visual Studio 禁用 GitHub Copilot AI 代码提示的设置方法

相关免费在线工具

  • 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