一、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,输入:
# 添加单个文件
git add test.py
# 添加所有修改的文件(推荐)
git add .
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)、解决冲突等进阶内容,适合项目的版本管理。

