1. 引言什么是 GiteeGitee码云是国内领先的代码托管与协作开发平台基于 Git 技术构建为开发者提供代码托管、版本管理、项目管理、团队协作、持续集成等一站式服务。与 GitHub 相比Gitee 在国内访问速度快、中文界面友好并且提供了免费私有仓库非常适合个人开发者、学生团队以及企业内部使用。本教程将从零开始带你完整掌握 Gitee 的注册、仓库创建、代码上传、分支管理、团队协作等核心操作即使你完全没有使用过 Git也能跟着教程一步步完成。2. 准备工作注册与登录 Gitee2.1 注册账号打开浏览器访问 Gitee 官网Gitee - 基于 Git 的代码托管和研发协作平台。点击页面右上角的「注册」按钮进入注册页面。注册方式有以下几种手机号注册输入手机号获取验证码设置密码即可完成注册。邮箱注册输入邮箱地址设置密码系统会发送激活邮件点击邮件中的链接完成激活。第三方账号登录支持微信、QQ、微博等第三方账号直接登录首次登录时需绑定手机号或邮箱。注册完成后建议完善个人资料包括头像、昵称、个人简介等方便团队成员识别你的身份。2.2 安装git安装git Git for Windows不会操作的看这个Git 教程 | 菜鸟教程。右键桌面有下面样式就是安装成功3. 创建你的第一个仓库3.1 新建仓库登录 Gitee 后点击页面右上角的「」号选择「新建仓库」或者直接访问新建仓库页面https://gitee.com/projects/new。在新建仓库页面需要填写以下信息仓库名称必填项建议使用英文、数字、下划线或中划线例如 my-project、hello_world。路径仓库的访问路径默认与仓库名称一致可以手动修改。仓库介绍可选用一句话描述这个仓库是做什么的。是否开源选择「公开」或「私有」。公开仓库所有人都能看到私有仓库只有你和被邀请的成员能访问。初始化仓库可以选择「初始化仓库」并添加 README 文件、选择 .gitignore 模板如 Java、Python、Node.js 等、选择开源许可证如 MIT、Apache 2.0 等。填写完成后点击「创建」按钮仓库就创建成功了。3.2 仓库页面结构创建成功后你会进入仓库主页。仓库主页主要包含以下区域文件列表展示仓库根目录下的所有文件和文件夹。提交记录展示最近的代码提交历史。分支展示仓库的所有分支默认分支通常是 master 或 main。标签用于标记版本发布点。仓库地址页面右侧或「克隆/下载」按钮中可以看到仓库的 HTTPS 和 SSH 地址。4. 安装与配置 Git4.1 安装 GitGitee 是基于 Git 的代码托管平台因此你需要在本地安装 Git 客户端。根据操作系统选择对应的安装方式Windows访问 Git 官网 Redirecting…下载 Windows 版本安装包双击安装一路默认即可。macOS可以通过 Homebrew 安装在终端执行brew install git或者从官网下载 macOS 版本安装包。LinuxUbuntu/Debian在终端执行sudo apt install git。LinuxCentOS/RHEL在终端执行sudo yum install git。安装完成后在终端或命令行中输入git --version如果能看到版本号说明安装成功。4.2 配置用户信息Git 提交代码时需要记录提交者的姓名和邮箱。打开终端执行以下命令配置全局用户信息git config --global user.name 你的名字 git config --global user.email 你的邮箱example.com这里的名字和邮箱建议与 Gitee 账号保持一致这样提交记录才能正确关联到你的 Gitee 账号。可以通过以下命令查看当前配置git config --list5. 配置 SSH 公钥推荐5.1 为什么使用 SSH使用 HTTPS 方式克隆和推送代码时每次都需要输入账号密码比较麻烦。配置 SSH 公钥后可以实现免密操作更加安全便捷。推荐使用 SSH 方式与 Gitee 交互。5.2 生成 SSH 密钥打开终端执行以下命令生成 SSH 密钥对ssh-keygen -t rsa -b 4096 -C 你的邮箱example.com执行后系统会提示你选择保存位置直接回车使用默认位置~/.ssh/id_rsa即可。接着会提示输入密码短语passphrase可以直接回车跳过也可以设置一个密码短语增加安全性。生成完成后查看公钥内容cat ~/.ssh/id_rsa.pub复制输出的完整内容以ssh-rsa开头。如图复制到公钥里5.3 在 Gitee 中添加公钥登录 Gitee点击右上角头像进入「设置」页面选择左侧「安全设置」下的「SSH 公钥」。点击「添加公钥」将刚才复制的公钥内容粘贴到「公钥」输入框中填写一个便于识别的标题如「我的电脑」点击「确定」保存。添加成功后可以在终端测试连接ssh -T gitgitee.com如果看到类似Hi 你的名字! Youve successfully authenticated的提示说明 SSH 配置成功。6. 克隆仓库到本地首先可以新建一个仓库然后按照他的操作步骤操作即可当然你可以新建一个本地的文件夹和仓库进行连接在文件加中右键点击下面这个然后按照操作步骤操作即可如图6.1 获取仓库地址进入你的仓库主页点击「克隆/下载」按钮可以看到两种地址HTTPS 地址形如https://gitee.com/用户名/仓库名.git。SSH 地址形如gitgitee.com:用户名/仓库名.git。如果你已经配置了 SSH 公钥推荐使用 SSH 地址。6.2 执行克隆命令打开终端进入你想要存放项目的目录执行以下命令git clone gitgitee.com:用户名/仓库名.git执行后Git 会将远程仓库的所有文件下载到本地并自动创建一个与仓库同名的文件夹。进入该文件夹cd 仓库名此时你就拥有了一个完整的本地仓库可以开始开发了。7. 提交代码到 Gitee7.1 基本提交流程在本地修改或新增文件后需要经过以下三个步骤才能将代码推送到 Gitee第一步查看当前状态git status该命令会显示当前工作区的状态哪些文件被修改、哪些文件是新增的。第二步添加文件到暂存区添加单个文件git add 文件名添加所有修改的文件git add .第三步提交到本地仓库git commit -m 提交说明提交说明建议写清楚本次改动的内容例如git commit -m 新增登录功能。第四步推送到远程仓库git push origin master其中origin是远程仓库的默认名称master是分支名称。如果你的默认分支是main则执行git push origin main。7.2 首次推送的完整示例假设你已经在本地创建了一个项目文件夹里面有一些代码文件现在要把它推送到 Gitee 上新建的空仓库。完整流程如下# 进入项目文件夹 cd my-project 初始化本地仓库 git init 添加所有文件到暂存区 git add . 提交到本地仓库 git commit -m 首次提交 添加远程仓库地址 git remote add origin gitgitee.com:用户名/my-project.git 推送到远程仓库 git push -u origin master其中-u参数会将本地分支与远程分支关联起来之后再次推送时只需执行git push即可。8. 分支管理8.1 什么是分支分支是 Git 中非常重要的概念。简单来说分支就是一条独立的开发线。你可以在分支上进行功能开发、Bug 修复而不会影响主分支master 或 main的稳定性。开发完成后再将分支合并回主分支。8.2 常用分支操作查看所有分支git branch创建新分支git branch 分支名切换分支git checkout 分支名也可以使用git switch 分支名Git 2.23 及以上版本支持。创建并切换分支一步完成git checkout -b 分支名合并分支先切换到目标分支如 master再执行合并git checkout master git merge 分支名删除分支git branch -d 分支名推送分支到远程git push origin 分支名8.3 分支开发流程示例一个典型的分支开发流程如下# 从主分支创建功能分支 git checkout -b feature-login 在功能分支上开发、提交 git add . git commit -m 完成登录功能开发 推送功能分支到远程 git push origin feature-login 切回主分支 git checkout master 合并功能分支 git merge feature-login 推送主分支到远程 git push origin master 删除本地功能分支 git branch -d feature-login9. 团队协作多人开发同一仓库9.1 邀请成员加入仓库进入仓库主页点击「管理」按钮在左侧菜单中选择「成员管理」然后点击「添加成员」。输入成员的 Gitee 用户名或邮箱选择角色权限观察者只能查看代码不能修改。报告者可以提交 Issue但不能推送代码。开发者可以推送代码、管理分支是常用的协作角色。管理员拥有仓库全部权限包括成员管理、删除仓库等。添加完成后成员就可以通过克隆地址获取代码并参与开发了。9.2 拉取最新代码在多人协作时每次开发前建议先拉取远程最新代码避免基于过期代码开发。执行git pull该命令会从远程仓库拉取最新代码并自动合并到当前分支。9.3 解决合并冲突当多个成员修改了同一个文件的同一部分时合并时会产生冲突。Git 会在冲突文件中标记冲突区域格式如下 HEAD 当前分支的内容 其他分支的内容 分支名你需要手动编辑文件保留正确的内容删除冲突标记然后重新提交git add 冲突文件 git commit -m 解决冲突9.4 使用 Pull RequestPR进行代码审查在团队协作中推荐使用 Pull Request合并请求流程开发者将功能分支推送到远程后在 Gitee 仓库页面点击「Pull Requests」→「新建 Pull Request」选择源分支和目标分支填写描述提交后由其他成员进行代码审查审查通过后点击「合并」按钮完成合并。这种方式可以有效保证代码质量。10. Gitee 常用功能进阶10.1 Issue 管理Issue 是 Gitee 提供的任务管理和问题跟踪工具。在仓库页面点击「Issues」可以创建 Issue用于记录 Bug、功能需求、任务分配等。每个 Issue 可以设置标签、指派负责人、设置优先级和截止日期非常适合敏捷开发。10.2 Wiki 文档Gitee 为每个仓库提供了 Wiki 功能可以编写项目文档、使用说明、设计文档等。点击仓库页面的「Wiki」标签即可进入编辑支持 Markdown 语法方便团队沉淀知识。10.3 Releases 版本发布当项目开发到一定阶段可以发布版本。在仓库页面点击「Releases」→「新建 Release」填写版本号如 v1.0.0、标题和发布说明还可以上传附件如编译好的安装包。发布后用户可以下载对应版本的代码或附件。10.4 代码审查与质量分析Gitee 内置了代码质量分析功能可以在仓库「管理」→「仓库设置」中开启。开启后每次推送代码都会自动进行静态分析帮助发现潜在的代码问题。10.5 Gitee Pages 静态网站托管Gitee 提供了 Pages 服务可以将仓库中的静态网页HTML、CSS、JavaScript部署为在线网站。在仓库「服务」→「Gitee Pages」中开启选择部署分支和目录即可生成一个https://用户名.gitee.io/仓库名的访问地址。注意Gitee Pages 需要实名认证后才能使用。