三、Gitee平台使用指南 - 教程

Gitee平台使用指南

1. Gitee简介

什么是Gitee

Gitee（码云）是开源中国（OSChina）推出的基于Git的代码托管平台，是国内最大的代码托管平台之一。

Gitee的优势

国内访问速度快：服务器位于国内，访问速度优于GitHub
中文界面：提供完整的中文界面和文档
免费私有仓库：提供免费的私有仓库服务
企业级功能：支持企业级项目管理
丰富的集成：支持多种开发工具和CI/CD集成

与GitHub的对比

特性	Gitee	GitHub
服务器位置	国内	国外
访问速度	快	较慢
界面语言	中文	英文
私有仓库	免费	付费
企业功能	丰富	基础

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：修复bug
docs：文档更新
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: 进入仓库设置 → 基本信息 → 修改可见性

posted @ 2025-09-03 11:41 yfceshi 阅读(80) 评论(0) 收藏举报

刷新页面返回顶部