目录
[2.1 先拉取后提交](#2.1 先拉取后提交)
[2.2 先初始化后提交](#2.2 先初始化后提交)
[3.1 代码冲突](#3.1 代码冲突)
[3.2 分支推送失败](#3.2 分支推送失败)
[3.3 认证失败](#3.3 认证失败)
[3.4 网络与连接](#3.4 网络与连接)
1、概念
码云(Gitee):是中国本土一个非常主流的代码托管与协作开发平台。
| 特性维度 | 具体说明 | 
|---|---|
| 中文名/别名 | 码云 | 
| 官方定位 | 基于 Git 的代码托管平台、企业级研发效能平台 | 
| 核心特点 | 本土化服务 :全中文环境,服务器在国内,访问速度快 免费额度高 :个人用户可创建大量免费私有仓库 一体化 DevOps:提供从代码托管到 CI/CD、项目管理的全流程服务 | 
| 主要用户 | 个人开发者、初创团队、中国企业(特别是对数据合规有要求的金融、政府、军工等)、高校师生 | 
| 核心功能 | 代码托管、项目管理(Issues、Wiki、看板)、代码审查、CI/CD、静态页面托管等 | 
主要产品:
- 
Gitee 社区版:这是大家最常接触的免费版本,为开发者提供基础的代码托管、协作开发服务,并拥有活跃的开源社区。 
- 
Gitee 企业版:面向企业的公有云 DevOps 平台,提供一站式研发协作和项目管理服务。 
- 
Gitee 旗舰版:为超大型企业提供的私有化部署方案,满足更高的安全、合规和定制化需求,覆盖从项目管理、代码托管到持续交付的全链路。 
- 
Gitee 高校版:专门为高校计算机教学设计的平台,提供班级管理、课程管理、布置批改作业等功能。 

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" (未合并)状态,这些就是冲突文件。
- 
解决冲突 :打开冲突文件,会看到如下标记,需要决定保留哪一部分的代码,或者将两者合理地整合 ,然后删除这些标记( <<<<<<<,=======,>>>>>>>)。
            
            
              bash
              
              
            
          
          <<<<<<< 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方式,请确保: - 
SSH公钥(通常是 id_rsa.pub或id_ed25519.pub文件的内容)已正确添加到Gitee账户的SSH公钥设置中。
- 
可以通过命令 ssh -T git@gitee.com测试连接,成功时会收到欢迎信息。
 
- 
3.4 网络与连接
- 
清理代理设置 :如果之前为Git配置过代理,但代理服务器不可用,可能导致连接失败。可以尝试执行 git config --global --unset http.proxy和git config --global --unset https.proxy来取消全局代理设置。
- 
检查Gitee服务状态:偶尔Gitee平台本身可能出现服务波动,可以关注其官方状态页面或公告。