Gitee从入门到上手:注册+Git/小乌龟安装+代码提交全流程
Gitee(码云)是国内使用的代码托管平台,使用它可以轻松实现版本管理和代码备份。这篇教程从0开始,覆盖注册、工具安装、仓库操作到代码提交的全流程,新手跟着做就能上手,附小乌龟(TortoiseGit)可视化操作,不用死记命令行~
文章目录
一、Gitee账号注册(网页端)
1. 访问官网
打开浏览器,输入Gitee官网地址:https://gitee.com/,点击右上角「注册」按钮。
2. 完成注册
- 支持手机号/邮箱注册;
- 设置用户名(建议英文+数字,作为个人空间唯一标识)、密码,完成短信/邮箱验证;
- 注册成功后登录,完善个人信息(可选),即可进入Gitee主页。
二、必备工具安装(Git+小乌龟)
新手推荐「Git命令行 + 小乌龟(TortoiseGit)可视化」组合,既懂底层逻辑,又能简化操作。
1. Git安装
- 下载地址:https://git-scm.com/downloads(选择对应系统版本,Windows选64-bit Git for Windows Setup);
- 安装步骤:
- 双击安装包,一路「Next」,默认配置即可;
- 关键步骤:勾选「Add Git to PATH」(让系统识别git命令),编辑器可选「Vim」或「Notepad++」;
- 安装完成后,右键桌面→「Git Bash Here」,输入
git --version,显示版本号即安装成功。
2. 小乌龟(TortoiseGit)安装
TortoiseGit是Windows下的Git可视化工具,不用记命令,右键就能操作,新手友好:
- 下载地址:https://tortoisegit.org/download/(先装Git再装小乌龟!);
- 安装步骤:
- 选择对应系统版本(64-bit),下载后双击安装;
- 语言选择「Chinese (Simplified)」(简体中文),一路「Next」;
- 安装完成后,右键桌面会出现「TortoiseGit」相关选项,代表安装成功;
- 配置小乌龟:右键→「TortoiseGit」→「设置」→「Git」→「用户信息」,填写和Gitee一致的用户名、邮箱(和Git全局配置保持统一)。
3. Git全局配置(关键!)
打开Git Bash,输入以下命令(替换成自己的Gitee用户名和邮箱),让Git识别你的身份:
git config --global user.name "你的Gitee用户名"git config --global user.email "你的Gitee注册邮箱"三、创建Gitee远程仓库
1. 新建仓库
登录Gitee后,点击右上角「+」→「新建仓库」,进入仓库创建页面:
- 仓库名称:必填,建议英文(如「python-homework」「data-structure-lab」);
- 路径:默认和用户名绑定,无需修改;
- 仓库介绍:可选,填写仓库用途(如「数据结构课程作业仓库」);
- 仓库类型:选「私有」(作业/个人项目)或「公共」(开源项目);
- 初始化仓库:勾选「使用README文件初始化仓库」(方便后续克隆);
- 点击「创建」,即可生成远程仓库。
2. 获取仓库地址
仓库创建成功后,点击「克隆/下载」,复制HTTPS地址(新手推荐,SSH需配置密钥,后续可进阶),比如:https://gitee.com/你的用户名/仓库名.git。
四、将远程仓库克隆到本地
方法1:命令行克隆(Git Bash)
- 选择本地存放代码的文件夹(如「D:\Code\Gitee」),右键→「Git Bash Here」;
- 输入克隆命令(替换成你的仓库地址):
git clone https://gitee.com/你的用户名/仓库名.git - 回车后,文件夹内会生成和仓库同名的目录,里面包含README文件,克隆成功。
方法2:小乌龟可视化克隆(新手首选)
- 新建空文件夹(如「D:\Code\Gitee-Test」),进入文件夹后右键→「Git 克隆…」;
- 在弹出的窗口中,「URL」粘贴复制的Gitee仓库地址,「目录」选择当前文件夹,点击「确定」;
- 等待克隆完成,文件夹内出现仓库文件,无需输入命令,更简单。
五、代码提交三板斧(add→commit→push)
克隆仓库后,在本地仓库目录下编写/修改代码(比如新建「test.py」文件),然后按以下步骤提交到Gitee:
1. 第一步:git add(添加到暂存区)
- 小乌龟方式:右键文件/文件夹→「TortoiseGit」→「Add」,选中要提交的文件,点击「确定」。
命令行方式:进入本地仓库目录,右键→Git Bash Here,输入:
# 添加单个文件gitadd test.py # 添加所有修改的文件(推荐)gitadd.2. 第二步:git commit(提交到本地仓库)
提交时必须写「提交说明」,清晰描述修改内容(如「完成test.py基础功能」「修复排序算法bug」)。
- 小乌龟方式:右键仓库目录→「TortoiseGit」→「Submit…」,在「日志信息」框填写提交说明,勾选要提交的文件,点击「Submit」。
命令行方式:
git commit -m "提交说明:完成test.py的HelloWorld功能"3. 第三步:git push(推送到Gitee远程仓库)
将本地提交的代码同步到Gitee,完成最终提交。
- 小乌龟方式:右键仓库目录→「TortoiseGit」→「Push…」,默认配置直接点击「确定」,输入账号密码后推送。
命令行方式:
git push 首次推送可能需要输入Gitee的用户名和密码,输入后即可推送成功。
4. 验证提交结果
打开Gitee仓库网页,刷新后能看到新增的「test.py」文件和提交记录,说明提交成功!
六、新手常见踩坑与解决
- push时提示「用户名或密码错误」:确认输入的是Gitee的用户名/邮箱和密码,不是手机号;若忘记密码,去Gitee官网重置。
- add后提示「nothing to commit」:检查文件是否在本地仓库目录内,或文件是否真的有修改(空文件也可提交)。
- 克隆仓库时速度慢/失败:换Gitee的镜像地址,或检查网络,确保能正常访问Gitee。
- 小乌龟右键无选项:重新安装小乌龟,确保先装Git再装小乌龟,且安装路径无中文。
七、总结
Gitee的核心操作流程就是「注册→建仓库→克隆到本地→修改代码→add/commit/push」,命令行和小乌龟任选一种即可,新手先掌握小乌龟可视化操作,再慢慢熟悉命令行。后续可以学习分支管理、拉取代码(git pull)、解决冲突等进阶内容,适合项目的版本管理,收藏起来备用吧~