1. 什么是 Gitee
Gitee(码云)是国内知名的代码托管平台,基于 Git 技术构建,提供代码托管、版本管理、团队协作、代码评审、持续集成等功能。相比 GitHub,Gitee 在国内访问速度快、中文界面友好,是许多开发者和企业首选的代码托管平台。
2. 注册与登录
2.1 注册账号
- 打开 Gitee 官网:https://gitee.com
- 点击右上角「注册」按钮
- 填写手机号或邮箱、用户名、密码等信息
- 完成手机验证或邮箱验证
- 注册成功后自动登录
2.2 完善个人资料
登录后建议完善个人资料,包括头像、昵称、个人简介等,方便团队协作时识别身份。
3. 创建仓库
3.1 新建仓库
- 登录后点击右上角「+」号,选择「新建仓库」
- 填写仓库名称(必填),如
my-project - 填写仓库描述(可选)
- 选择仓库类型:
- 私有仓库:仅自己和被邀请的成员可见
- 公开仓库:所有人可见
- 选择是否初始化仓库(添加 README、.gitignore、开源许可证)
- 点击「创建」按钮完成
3.2 仓库结构说明
创建完成后,仓库主页会显示:
- 代码文件列表
- 提交记录
- 分支信息
- 仓库地址(HTTPS 和 SSH 两种)
4. 安装与配置 Git
4.1 安装 Git
- Windows:从 https://git-scm.com 下载安装包,一路默认安装即可
- macOS:执行
brew install git或从官网下载安装 - Linux:执行
sudo apt install git(Ubuntu/Debian)或sudo yum install git(CentOS)
4.2 配置用户信息
安装完成后,打开终端(命令行),配置用户名和邮箱:
gitconfig--globaluser.name"你的用户名"gitconfig--globaluser.email"你的邮箱"5. 本地代码推送到 Gitee
5.1 方式一:克隆已有仓库
gitclone https://gitee.com/你的用户名/my-project.gitcdmy-project5.2 方式二:本地已有项目关联远程仓库
# 进入项目目录cdmy-project# 初始化 Git 仓库gitinit# 添加远程仓库地址gitremoteaddorigin https://gitee.com/你的用户名/my-project.git# 添加所有文件到暂存区gitadd.# 提交到本地仓库gitcommit-m"首次提交"# 推送到远程仓库gitpush-uorigin master提示:Gitee 默认分支名为
master,部分新仓库可能使用main,以仓库实际分支为准。
6. 日常提交与更新
6.1 提交代码
# 查看当前状态gitstatus# 添加修改的文件gitadd文件名# 或添加所有修改gitadd.# 提交gitcommit-m"提交说明"# 推送到远程gitpush6.2 拉取远程更新
gitpull7. 分支管理
7.1 创建与切换分支
# 创建新分支gitbranch dev# 切换到该分支gitcheckout dev# 或一步完成:创建并切换gitcheckout-bdev7.2 合并分支
# 先切回主分支gitcheckout master# 合并 dev 分支gitmerge dev# 推送合并结果gitpush8. 团队协作
8.1 邀请成员
在仓库页面点击「管理」→「成员管理」→「添加成员」,输入对方 Gitee 用户名或邮箱,设置权限(管理员、开发者、观察者等)。
8.2 Pull Request(PR)流程
- 开发者 Fork 主仓库到自己的账号下
- 在 Fork 的仓库中修改代码并推送
- 点击「新建 Pull Request」,选择源分支和目标分支
- 填写 PR 说明,提交给仓库管理员审核
- 管理员审核通过后合并代码
9. 常见问题
9.1 推送时提示认证失败
- 检查用户名和密码是否正确
- 推荐使用 SSH 方式:在「设置」→「安全设置」→「SSH 公钥」中添加本机公钥,然后使用 SSH 地址克隆和推送
9.2 推送被拒绝(non-fast-forward)
说明远程仓库有本地没有的提交,先执行git pull拉取合并后再推送。
9.3 如何删除仓库
在仓库「管理」→「仓库设置」→「删除仓库」,输入仓库名称确认后即可删除(操作不可恢复,请谨慎)。
10. 总结
Gitee 的使用核心流程可以概括为:注册账号 → 创建仓库 → 本地关联 → 提交推送 → 协作管理。掌握以上步骤后,你就可以用 Gitee 高效管理自己的代码项目了。建议多动手实践,遇到问题查阅 Gitee 官方帮助文档:https://gitee.com/help