本地项目上传 Gitee 完整操作指南
在日常开发或毕业设计中,将本地项目上传到代码托管平台是必备技能。Gitee(码云)作为国内优质的 Git 托管服务,不仅访问速度快,还支持私有仓库、协作者管理等实用功能,特别适合国内开发者和学生使用。本文将以「ESP32 车载声浪模拟控制系统」毕设项目为例,从环境准备到代码推送,一步步教你完成本地项目上传,同时揭秘新手常踩的坑及解决方案。
一、前置知识:核心概念快速理解
在开始操作前,先搞懂 3 个关键概念,避免后续 confusion:
- Git:本地代码版本控制工具,负责跟踪文件修改、管理提交记录,是连接本地项目和 Gitee 的桥梁;
- Gitee:远程代码托管平台,相当于'云端代码仓库',用于存储、共享你的项目;
- 分支(Branch):项目的'并行开发线',默认主分支为
main(新版 Git)或master(旧版 Git),推送时需保证本地分支与远程分支名称一致。
二、准备工作(3 步必做)
2.1 安装 Git 工具
Git 是上传项目的基础工具,支持 Windows/macOS/Linux 全平台:
- 下载地址:Git 官方下载(Windows 自动识别系统,直接下载 64 位安装包);
- 安装流程:全程点击「Next」默认安装(新手无需修改任何配置),直至「Finish」;
- 验证安装:按下
Win+R输入cmd,执行命令git --version,若显示git version x.x.x则安装成功。
2.2 注册并登录 Gitee 账号
- 访问 Gitee 官网:https://gitee.com/;
- 注册方式:用手机号快速注册,建议绑定邮箱(便于找回账号);
- 登录后进入个人主页,后续将在这里创建远程仓库。
2.3 配置 Git 与 Gitee 关联
让 Git 识别你的 Gitee 身份,避免后续推送权限报错:
- 右键桌面空白处,选择「Git Bash Here」打开 Git 命令窗口;
- 验证配置:执行
git config --global --list,能看到上述配置信息即生效。
执行以下命令(替换为你的 Gitee 用户名和注册邮箱):
# 配置用户名(Gitee 个人主页显示的昵称)
git config --global user.name "你的 Gitee 用户名"
# 配置邮箱(注册 Gitee 时使用的邮箱)
git config --global user.email "你的 Gitee 注册邮箱"
三、详细上传步骤(6 步搞定)
以本地 car_sound_simulation_control(ESP32 毕设项目)为例,完整上传流程如下:
3.1 步骤 1:在 Gitee 创建远程仓库
- 登录 Gitee 后,点击右上角「+」号 → 选择「新建仓库」;
- 点击「创建」,生成远程仓库,页面将显示仓库地址(如
https://gitee.com/host_brace/car_sound_simulation_control.git),复制该地址备用。
填写仓库信息(关键配置如下,其余默认):


