企业官网建设流程全解析

1. 引言：什么是 Gitee

Gitee（码云）是国内领先的代码托管与协作开发平台，基于 Git 技术构建，为开发者提供代码托管、版本管理、项目管理、团队协作、持续集成等一站式服务。与 GitHub 相比，Gitee 在国内访问速度快、中文界面友好，并且提供了免费私有仓库，非常适合个人开发者、学生团队以及企业内部使用。

本教程将从零开始，带你完整掌握 Gitee 的注册、仓库创建、代码上传、分支管理、团队协作等核心操作，即使你完全没有使用过 Git，也能跟着教程一步步完成。

2. 准备工作：注册与登录 Gitee

2.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. 安装与配置 Git

4.1 安装 Git

Gitee 是基于 Git 的代码托管平台，因此你需要在本地安装 Git 客户端。根据操作系统选择对应的安装方式：

• Windows：访问 Git 官网 Redirecting…，下载 Windows 版本安装包，双击安装，一路默认即可。
• macOS：可以通过 Homebrew 安装，在终端执行brew install git，或者从官网下载 macOS 版本安装包。
• Linux（Ubuntu/Debian）：在终端执行sudo apt install git。
• Linux（CentOS/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 --list

5. 配置 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 git@gitee.com

如果看到类似Hi 你的名字! You've successfully authenticated的提示，说明 SSH 配置成功。

6. 克隆仓库到本地

首先可以新建一个仓库：

然后按照他的操作步骤操作即可：

当然你可以新建一个本地的文件夹和仓库进行连接：

在文件加中右键点击下面这个

然后按照操作步骤操作即可如图：

6.1 获取仓库地址

进入你的仓库主页，点击「克隆/下载」按钮，可以看到两种地址：

• HTTPS 地址：形如https://gitee.com/用户名/仓库名.git。
• SSH 地址：形如git@gitee.com:用户名/仓库名.git。

如果你已经配置了 SSH 公钥，推荐使用 SSH 地址。

6.2 执行克隆命令

打开终端，进入你想要存放项目的目录，执行以下命令：

git clone git@gitee.com:用户名/仓库名.git

执行后，Git 会将远程仓库的所有文件下载到本地，并自动创建一个与仓库同名的文件夹。进入该文件夹：

cd 仓库名

此时，你就拥有了一个完整的本地仓库，可以开始开发了。

7. 提交代码到 Gitee

7.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 git@gitee.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-login

9. 团队协作：多人开发同一仓库

9.1 邀请成员加入仓库

进入仓库主页，点击「管理」按钮，在左侧菜单中选择「成员管理」，然后点击「添加成员」。输入成员的 Gitee 用户名或邮箱，选择角色权限：

• 观察者：只能查看代码，不能修改。
• 报告者：可以提交 Issue，但不能推送代码。
• 开发者：可以推送代码、管理分支，是常用的协作角色。
• 管理员：拥有仓库全部权限，包括成员管理、删除仓库等。

添加完成后，成员就可以通过克隆地址获取代码并参与开发了。

9.2 拉取最新代码

在多人协作时，每次开发前建议先拉取远程最新代码，避免基于过期代码开发。执行：

git pull

该命令会从远程仓库拉取最新代码并自动合并到当前分支。

9.3 解决合并冲突

当多个成员修改了同一个文件的同一部分时，合并时会产生冲突。Git 会在冲突文件中标记冲突区域，格式如下：

<<<<<<< HEAD 当前分支的内容 ======= 其他分支的内容 >>>>>>> 分支名

你需要手动编辑文件，保留正确的内容，删除冲突标记，然后重新提交：

git add 冲突文件 git commit -m "解决冲突"

9.4 使用 Pull Request（PR）进行代码审查

在团队协作中，推荐使用 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 需要实名认证后才能使用。