Gitee：代码管理

目录

1、概念

2、使用

2.1 先拉取后提交

2.2 先初始化后提交

3、常见问题

3.1 代码冲突

3.2 分支推送失败

3.3 认证失败

3.4 网络与连接

---

1、概念

码云（Gitee）：是中国本土一个非常主流的代码托管与协作开发平台。

特性维度	具体说明
中文名/别名	码云
官方定位	基于 Git 的代码托管平台、企业级研发效能平台
核心特点	本土化服务：全中文环境，服务器在国内，访问速度快 免费额度高：个人用户可创建大量免费私有仓库 一体化 DevOps：提供从代码托管到 CI/CD、项目管理的全流程服务
主要用户	个人开发者、初创团队、中国企业（特别是对数据合规有要求的金融、政府、军工等）、高校师生
核心功能	代码托管、项目管理（Issues、Wiki、看板）、代码审查、CI/CD、静态页面托管等

主要产品：

• Gitee 社区版：这是大家最常接触的免费版本，为开发者提供基础的代码托管、协作开发服务，并拥有活跃的开源社区。

• Gitee 企业版：面向企业的公有云 DevOps 平台，提供一站式研发协作和项目管理服务。

• Gitee 旗舰版：为超大型企业提供的私有化部署方案，满足更高的安全、合规和定制化需求，覆盖从项目管理、代码托管到持续交付的全链路。

• Gitee 高校版：专门为高校计算机教学设计的平台，提供班级管理、课程管理、布置批改作业等功能。

地址：https://gitee.com/

2、使用

2.1 先拉取后提交

场景：本地没有项目，先拉取项目，后添加更改后提交

• 创建仓库：登录 Gitee 后，点击"新建仓库"，填写名称、描述并设置公开/私有属性，这是管理代码的第一步。

• 克隆仓库：使用 git clone 命令将远程仓库复制到本地电脑，以便开始开发工作。

• 提交更改：在本地修改代码后，使用 git add 和 git commit -m "提交信息" 命令将更改提交到本地仓库。"提交信息"应清晰描述本次修改的内容。

• 推送代码：使用 git push 命令将本地提交推送到 Gitee 上的远程仓库，让团队成员看到你的更改。

• 协作与集成：你可以使用分支来开发新功能而不影响主代码，通过合并请求（Pull Request） 邀请同伴审查代码后再合并。此外，还可以利用 Gitee 内置的 CI/CD 功能实现自动化测试和部署。

2.2 先初始化后提交

场景：本地已经有了项目文件，但是远程还没有仓库，现在想把代码提交到仓库

创建仓库：登录 Gitee 后，点击"新建仓库"，填写名称、描述并设置公开/私有属性，这是管理代码的第一步。

• 创建仓库：登录 Gitee 后，点击"新建仓库"，填写名称、描述并设置公开/私有属性，这是管理代码的第一步。注意：不要勾选「初始化仓库」或「初始化readme文件」，因为本地已有代码

• 本地项目初始化：进入项目目录，执行 git init 初始化本地仓库，执行 git add . 将当前所有文件添加到暂存区，执行 git commit -m "初始提交：项目首次提交"，提交到本地仓库

• 关联远程仓库并推送：

  • 添加远程仓库地址（将URL替换为你刚创建的仓库地址）：git remote add origin https://gitee.com/你的用户名/你的仓库名.git

  • 推送代码到远程仓库的master/main分支：git push -u origin master

3、常见问题

3.1 代码冲突

当多人修改同一文件的同一部分时，Git无法自动合并，就会产生冲突。你需要手动解决：

• 定位冲突：使用 git status 命令，可以查看哪些文件处于 "Unmerged" （未合并）状态，这些就是冲突文件。

• 解决冲突：打开冲突文件，会看到如下标记，需要决定保留哪一部分的代码，或者将两者合理地整合，然后删除这些标记（<<<<<<<, =======, >>>>>>>）。

<<<<<<< HEAD
这是你本地修改的代码
=======
这是远程仓库的代码
>>>>>>> branch-name

• 完成合并：解决完所有冲突文件后，使用 git add <文件名> 将文件标记为已解决，然后执行 git commit 提交合并结果，最后 git push 推送即可。

3.2 分支推送失败

如果分支推送失败，可以按以下思路排查：

• 核对权限：确保你在Gitee上的该项目有推送（Push）权限。

• 同步远程代码：在推送前，最好先执行 git pull origin <分支名> 拉取远程最新代码，并与本地代码合并，这样可以减少因代码不一致导致的冲突。

• 确认分支存在：使用 git branch 命令确认你当前所在的本地分支，以及要推送的目标分支。

3.3 认证失败

• 检查系统凭据：如果你使用HTTPS方式克隆仓库，认证失败可能是因为系统保存的用户名或密码错误。可以到系统的凭据管理器（Windows）或钥匙串（macOS）中，查找并更新与gitee.com相关的凭据。

• 检查SSH配置：如果使用SSH方式，请确保：

  1. SSH公钥（通常是 id_rsa.pub 或 id_ed25519.pub 文件的内容）已正确添加到Gitee账户的SSH公钥设置中。

  2. 可以通过命令 ssh -T [e-mail] 测试连接，成功时会收到欢迎信息。

3.4 网络与连接

• 清理代理设置：如果之前为Git配置过代理，但代理服务器不可用，可能导致连接失败。可以尝试执行 git config --global --unset http.proxy 和 git config --global --unset https.proxy 来取消全局代理设置。

• 检查Gitee服务状态：偶尔Gitee平台本身可能出现服务波动，可以关注其官方状态页面或公告。