Gitee使用终极指南：从Git备份到与GitHub深度对比-优快云博客

Gitee使用终极指南：从Git备份到与GitHub深度对比

本文全面解析国内主流代码托管平台Gitee的使用方法，深度对比Gitee vs GitHub的区别，并给出双平台协同工作的最佳实践。

一、Gitee核心功能定位

Gitee（码云）是开源中国推出的代码托管平台，定位为中国本土化的GitHub替代品，主要解决国内开发者访问GitHub的网络问题。

特性	Gitee	GitHub
服务器位置	中国大陆	美国
访问速度	<50ms（国内）	150-500ms（国内）
语言支持	原生中文界面	需浏览器翻译
备案要求	需实名认证	无需实名
私有仓库	免费无限私有库	免费用户最多3人协作私有库

二、Git项目备份到Gitee全流程

步骤1：注册与初始化

访问 gitee.com 注册账号
完成实名认证（必需步骤）
创建新仓库：

点击右上角➕ → 新建仓库
填写仓库名称（建议与本地项目同名）
重要设置：

[✓] 私有仓库
[✓] 使用Readme文件初始化仓库
[ ] 启用分支管理模型（可选）

步骤2：配置SSH密钥

# 生成SSH密钥（本地终端）
ssh-keygen -t ed25519 -C "your_email@example.com"
cat ~/.ssh/id_ed25519.pub

# 添加密钥到Gitee
# 个人设置 → SSH公钥 → 粘贴密钥

步骤3：本地项目关联Gitee

# 进入项目目录
cd your-project

# 初始化Git（若未初始化）
git init

# 添加远程仓库
git remote add gitee git@gitee.com:yourname/repo.git

# 验证关联
git remote -v
# 显示：gitee git@gitee.com:yourname/repo.git (fetch)
#gitee git@gitee.com:yourname/repo.git (push)

步骤4：首次推送备份

git add .
git commit -m "Initial commit"
git push -u gitee master# 或 main

步骤5：设置自动备份（crontab）

# 创建备份脚本 backup.sh
#!/bin/bash
cd /path/to/your-project
git add .
git commit -m "Auto backup $(date +'%Y-%m-%d %H:%M')"
git push gitee

# 添加每日备份任务
crontab -e
# 添加：0 2 * * * /bin/bash /path/to/backup.sh

三、Gitee vs GitHub 全方位对比

1. 仓库管理对比

功能	Gitee	GitHub
仓库大小限制	5GB（免费）	100GB（需申请）
单文件限制	100MB	100MB（推荐≤50MB）
LFS支持	✓ 免费50GB	✓ 免费1GB
仓库归档	✓	✓

2. 协作功能差异

功能	Gitee	GitHub
Pull Request	合并请求（功能相同）	Pull Request
Code Review	✓ 基础评审功能	✓ 高级评审工具（建议变更等）
任务管理	内置任务看板	依赖Projects/Issues
Wiki	✓ 支持	✓ 功能更强大

3. 持续集成/部署（CI/CD）

服务	Gitee Go	GitHub Actions
免费额度	每月1000分钟	每月2000分钟
配置文件位置	.gitee/.gitee.golang.yml	.github/workflows/*.yml
运行环境	国内服务器（快速）	微软Azure全球节点
Docker支持	✓	✓

4. Pages静态站点

特性	Gitee Pages	GitHub Pages
访问速度	国内极快	国内较慢
HTTPS支持	✓（自动Let’s Encrypt）	✓（自动证书）
自定义域名	✓ 需备案	✓ 无需备案
构建限制	Jekyll/Hugo/Hexo	支持更多静态生成器

四、双平台协同策略

方案1：镜像同步（自动备份）

# 同时添加两个远程源
git remote add github git@github.com:user/repo.git
git remote add gitee git@gitee.com:user/repo.git

# 一键推送脚本 push_all.sh
#!/bin/bash
git push github master
git push gitee master

# 执行权限
chmod +x push_all.sh

方案2：Gitee镜像GitHub（实时同步）

Gitee仓库 → 管理 → 仓库镜像管理
填写GitHub仓库URL
设置同步方向：

只从GitHub同步（推荐）
双向同步

开启定时同步（每小时/每天）

方案3：分支分离策略

github-main：适配GitHub环境的分支
gitee-main：适配Gitee环境的分支
main：通用代码合并分支

五、Gitee特色功能详解

1. 仓库快照（防删库）

功能入口：仓库 → 管理 → 仓库快照
作用：防止恶意删除，可一键恢复
保留策略：最近3次提交的快照

2. GVP认证项目

Gitee精选开源项目（Gitee Valued Project）
特权：
专属标识 ✅
优先技术支持
推广资源倾斜
申请条件：⭐>100，持续维护6个月以上

3. 代码质量分析

使用开源工具 CodeDog
检测项目：
代码重复率
潜在BUG
安全漏洞
入口：仓库 → 代码质量

六、企业版功能对比

功能	Gitee企业版	GitHub企业版
价格	¥399/用户/年	$21/用户/月
部署方式	云托管/私有化部署	云托管/本地部署
权限管理	精细化部门权限	Teams权限体系
效能洞察	✓ 研发数据可视化	✓ Advanced Insights
专项支持	中文客服（7×12h）	英文工单

七、常见问题解决

Q1：Push失败报错「没有权限」

# 检查密钥配置
ssh -T git@gitee.com# 应返回：Hello YourName! You've successfully authenticated

# 解决方案：
chmod 700 ~/.ssh
chmod 600 ~/.ssh/id_ed25519

Q2：GitHub同步延迟

原因：跨境网络波动
解决方案：

手动触发同步
使用国内CI服务（如Jenkins）中转
配置Webhook双向通知

Q3：大文件上传失败

# 安装Git LFS
git lfs install

# 跟踪大文件
git lfs track "*.psd"

# 提交并推送
git add .gitattributes
git add asset.psd
git commit -m "Add design file"
git push gitee main