Gitee 代码上传超详细教程（新手友好·实测可行）

本教程专为 Git 新手设计，无需复杂编程基础，只需跟着步骤一步步操作，即可轻松将本地代码上传至 Gitee 远程仓库，适用于个人项目管理、团队协作等场景。

一、前期准备（必做！）

在开始上传操作前，需完成以下 2 项基础配置，避免后续步骤出错：

1. 安装 Git 工具：前往 Git 官网 下载对应系统（Windows/macOS/Linux）的安装包，按默认向导完成安装（Windows 系统建议勾选“Add Git Bash Here to Context Menu”，方便后续右键打开命令行）。
2. 注册并登录 Gitee：进入 Gitee 官网，完成账号注册后登录，后续需在该平台创建存储代码的远程仓库。

二、具体操作步骤（10步搞定）

步骤1：创建 Gitee 远程仓库

1. 登录 Gitee 后，点击右上角「+」号，选择「新建仓库」；
2. 填写仓库基础信息：
   • 仓库名称：建议与本地项目名称一致（如“student-manage-system”），便于识别；
   • 仓库介绍：简要说明项目用途（如“学生信息管理系统前端代码”）；
   • 仓库类型：个人项目选“私有”，开源项目选“公有”；
   • 其他选项：默认勾选“初始化 README 文件”（便于后续同步），点击「创建」完成。
3. 仓库创建后，复制页面中的「HTTPS 链接」（如 https://gitee.com/your-name/student-manage-system.git），后续需用该链接关联本地代码。

步骤2：打开本地项目的 Git 命令行

1. 找到本地代码所在的文件夹（如“D:\projects\student-manage-system”）；
2. 在文件夹空白处右键，选择「Git Bash Here」（Windows 系统）或通过终端进入该文件夹（macOS/Linux 系统），打开 Git 命令行窗口。

步骤3：配置 Git 用户名和邮箱（首次使用需配置）

在命令行中输入以下 2 条命令，完成身份配置（替换为你的 Gitee 用户名和邮箱）：

git config --global user.name "你的 Gitee 用户名"
git config --global user.email "你的 Gitee 绑定邮箱"

• 配置后可输入以下命令验证是否成功：

  git config user.name  # 显示用户名即成功
  git config user.email # 显示邮箱即成功
  

步骤4：初始化本地仓库

在命令行中输入以下命令，将当前文件夹初始化为 Git 可管理的本地仓库（初始化后文件夹会新增隐藏的“.git”文件夹，无需手动修改）：

git init

• 出现“Initialized empty Git repository in ...”提示，说明初始化成功。

步骤5：将本地代码添加到暂存区

输入以下命令，将文件夹内所有文件（包括子文件夹）添加到 Git 暂存区，准备后续提交：

git add .

• 注意命令中的“.”代表“当前文件夹下所有文件”，若只需添加单个文件，可将“.”替换为文件名（如 git add index.html）。

步骤6：提交代码到本地仓库

输入以下命令，将暂存区的代码提交到本地仓库，并添加提交说明（说明需简洁明确，方便后续追溯修改记录）：

git commit -m "首次提交：完成学生管理系统登录页面开发"

• 出现类似“1 file changed, 10 insertions(+)”的提示，说明提交成功。

步骤7：关联本地仓库与 Gitee 远程仓库

输入以下命令，将本地仓库与步骤1中复制的 Gitee 远程仓库链接关联（替换命令中的“远程仓库HTTPS链接”为你实际复制的链接）：

git remote add origin 远程仓库HTTPS链接

• 若出现“fatal: remote origin already exists”错误，说明已关联过仓库，可先输入 git remote rm origin 删除旧关联，再重新执行上述命令。

步骤8：同步远程仓库文件（关键！避免冲突）

若 Gitee 远程仓库已存在文件（如 README.md），需先同步远程文件到本地，避免后续推送时出现冲突：

git pull --rebase origin master

• 若远程仓库为空（未勾选“初始化 README 文件”），可跳过此步骤；
• 出现“Already up to date”提示，说明本地与远程文件已同步。

步骤9：推送本地代码到 Gitee 远程仓库

输入以下命令，将本地仓库的代码推送到 Gitee 远程仓库：

git push -u origin master

• 首次推送会弹出登录窗口，输入你的 Gitee 用户名和密码（或使用 Gitee 令牌登录，令牌需在 Gitee 「设置-安全设置-私人令牌」中创建）；
• 出现“100% (3/3), done.”提示，说明推送成功。

步骤10：验证上传结果

1. 回到 Gitee 远程仓库页面，点击页面刷新按钮；
2. 若能看到本地项目中的文件（如“login.html”“style.css”），说明代码已成功上传。

三、常见问题解决

1. **推送时提示“Username for 'gitee.com':”**：直接输入 Gitee 用户名，按回车后输入密码（输入密码时命令行无显示，正常输入即可）。
2. 出现“error: failed to push some refs to ...”：通常是未同步远程文件，重新执行步骤8的 git pull --rebase origin master 命令即可。
3. “git add .”后想取消添加：输入 git reset HEAD 可取消暂存区的所有文件添加。

我已将这份教程整理成了 Markdown 格式的文档文件，你可以直接保存到本地随时查阅，需要我将文档内容发给你吗？