Gitee平台使用指南1. Gitee简介什么是GiteeGitee(码云)是开源中国(OSChina)推出的基于Git的代码托管平台,是国内最大的代码托管平台之一。
Gitee的优势国内访问速度快:服务器位于国内,访问速度优于GitHub中文界面:提供完整的中文界面和文档免费私有仓库:提供免费的私有仓库服务企业级功能:支持企业级项目管理丰富的集成:支持多种开发工具和CI/CD集成与GitHub的对比特性GiteeGitHub服务器位置国内国外访问速度快较慢界面语言中文英文私有仓库免费付费企业功能丰富基础2. 注册与配置注册账号访问 gitee.com点击"注册"按钮填写用户名、邮箱、密码验证邮箱完成注册配置SSH密钥
# 生成SSH密钥
ssh-keygen -t rsa -C "你的邮箱@example.com"
# 查看公钥内容
cat ~/.ssh/id_rsa.pub
添加SSH密钥到Gitee登录Gitee点击右上角头像 → 设置左侧菜单选择"SSH公钥"点击"添加公钥"粘贴公钥内容并保存测试SSH连接
ssh -T git@gitee.com
3. 仓库管理创建仓库登录Gitee点击右上角"+"号 → “新建仓库”填写仓库信息:
仓库名称仓库介绍是否公开是否初始化README点击"创建"仓库设置基本信息:修改仓库名称、描述分支管理:设置默认分支、保护分支成员管理:添加协作者WebHook:配置自动化触发4. 代码管理上传代码到Gitee
# 方法1:克隆后推送
git clone https://gitee.com/username/repository.git
# 添加文件后
git add .
git commit -m "初始提交"
git push origin main
# 方法2:本地仓库关联
git remote add origin https://gitee.com/username/repository.git
git push -u origin main
使用SSH方式
# 使用SSH地址克隆
git clone git@gitee.com:username/repository.git
# 推送代码
git push origin main
5. 团队协作添加协作者进入仓库页面点击"管理" → “成员管理”点击"添加成员"输入用户名或邮箱设置权限级别权限级别访客:只能查看代码报告者:可以创建Issue和Pull Request开发者:可以推送代码到非保护分支维护者:可以管理仓库设置管理员:拥有所有权限Pull Request流程创建分支:基于主分支创建功能分支开发功能:在分支上进行开发推送分支:将分支推送到Gitee创建PR:在Gitee上创建Pull Request代码审查:团队成员进行代码审查合并代码:审查通过后合并到主分支6. Issue管理创建Issue进入仓库页面点击"Issues"标签点击"新建Issue"填写标题和描述设置标签和里程碑Issue模板可以创建Issue模板来标准化问题报告:
## 问题描述
[详细描述遇到的问题]
## 复现步骤
1.
2.
3.
## 期望结果
[描述期望的正确行为]
## 实际结果
[描述实际发生的情况]
## 环境信息
- 操作系统:
- 版本:
- 其他相关信息:
7. 项目管理里程碑管理创建里程碑设置截止日期关联Issue和Pull Request跟踪项目进度标签管理bug:程序错误enhancement:功能增强documentation:文档相关help wanted:需要帮助question:问题讨论8. 高级功能Gitee Pages进入仓库设置启用Gitee Pages选择分支和目录访问生成的网站Gitee Go(CI/CD)创建.gitee/workflows目录编写工作流配置文件配置构建和部署步骤示例工作流配置
name: 构建和测试
on:
push:
branches: [ main ]
pull_request:
branches: [ main ]
jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
- name: 设置Node.js
uses: actions/setup-node@v2
with:
node-version: '14'
- name: 安装依赖
run: npm install
- name: 运行测试
run: npm test
9. 最佳实践提交信息规范
():
类型说明:
feat:新功能fix:修复bugdocs:文档更新style:代码格式调整refactor:代码重构test:测试相关chore:构建过程或辅助工具的变动分支命名规范main/master:主分支develop:开发分支feature/xxx:功能分支hotfix/xxx:紧急修复分支release/xxx:发布分支代码审查要点代码逻辑是否正确是否有潜在的安全问题代码风格是否一致是否有适当的注释测试是否充分10. 常见问题Q: 如何删除仓库?A: 进入仓库设置 → 高级设置 → 删除仓库
Q: 如何转移仓库所有权?A: 进入仓库设置 → 高级设置 → 转移仓库
Q: 如何备份仓库?A: 使用git clone --mirror创建镜像仓库
Q: 如何查看仓库统计信息?A: 在仓库页面查看"统计"标签页
Q: 如何设置仓库可见性?A: 进入仓库设置 → 基本信息 → 修改可见性