一、本地代码文件夹上传到远程 Gitee 仓库的完整步骤

根据「本地文件夹是否已初始化 Git 仓库」分两种场景，步骤覆盖从准备到推送的全流程，新手优先看「场景 1（全新文件夹）」：

前提准备（必做）

1. 本地环境准备：
   • 安装 Git（官网：https://git-scm.com/），并配置 Git 用户名 / 邮箱（和 Gitee 账号一致）：

     bash

     运行

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

   • （可选）配置 SSH 免密（避免每次推送输账号密码）：参考 Gitee 官方文档「SSH 公钥配置」。
2. Gitee 远程仓库准备：
   • 登录 Gitee → 右上角「+」→「新建仓库」→ 填写仓库名、选择公开 / 私有 → 不要勾选「初始化仓库」（避免生成 README / 许可证等文件，导致推送冲突） → 点击「创建」。
   • 复制仓库地址：创建后页面会显示「HTTPS 地址」（如https://gitee.com/用户名/仓库名.git）或「SSH 地址」（如git@gitee.com:用户名/仓库名.git），任选其一（SSH 免密更方便）。

---

场景 1：本地文件夹未初始化 Git（全新代码文件夹）

bash

运行

# 步骤1：打开终端/CMD，进入本地代码文件夹（替换为你的文件夹路径）
cd /Users/xxx/Desktop/your-code-folder  # Mac/Linux
# 或
cd D:\xxx\your-code-folder  # Windows

# 步骤2：初始化Git仓库（生成.git隐藏文件夹，标记为Git仓库）
git init

# 步骤3：将所有文件添加到Git暂存区（.表示当前目录所有文件）
# 若只想添加指定文件：git add src/index.js README.md
git add .

# 步骤4：提交暂存区文件到本地版本库（必须写提交说明，描述改了什么）
git commit -m "首次提交：上传xxx项目基础代码"

# 步骤5：关联远程Gitee仓库（origin是远程仓库默认别名，替换为你的仓库地址）
git remote add origin git@gitee.com:你的用户名/你的仓库名.git  # SSH地址
# 或
git remote add origin https://gitee.com/你的用户名/你的仓库名.git  # HTTPS地址

# 步骤6：推送本地代码到远程Gitee仓库（-u 绑定本地分支和远程分支，后续可直接git push）
# 分支名：Gitee默认是master/main，也可指定自定义分支（如front）
git push -u origin master  # 推送到远程master分支
# 或
git push -u origin front   # 推送到远程front分支

---

场景 2：本地文件夹已初始化 Git（已有.git 文件夹）

仅需补充「关联远程仓库 + 推送」步骤：

bash

运行

# 步骤1：进入本地代码文件夹
cd 你的代码文件夹路径

# 步骤2：关联远程Gitee仓库（若已关联过，可跳过；若需替换，先执行git remote remove origin）
git remote add origin 你的Gitee仓库地址

# 步骤3：（可选）检查远程仓库关联是否正确
git remote -v

# 步骤4：推送代码到远程（-u 绑定分支，首次推送需加）
git push -u origin 分支名（如master/front）

---

常见问题解决

• 推送报错「远程仓库已有文件（如 README），无法推送」：

  bash

  运行

  # 先拉取远程文件并合并（--allow-unrelated-histories 允许无关联历史合并）
  git pull origin 分支名 --allow-unrelated-histories
  # 解决合并冲突（手动删除冲突标记后），再重新提交+推送
  git add .
  git commit -m "合并远程README文件"
  git push origin 分支名
  

• 推送提示「权限不足」：检查 Gitee 仓库权限、SSH 公钥是否配置正确，或改用 HTTPS 地址（推送时输入 Gitee 账号密码）。

二、Gitee 常用 Git 命令（分类整理，新手必备）

1. 仓库基础操作

命令	作用	示例
git init	初始化本地 Git 仓库	git init
git clone <仓库地址>	克隆远程 Gitee 仓库到本地	git clone git@gitee.com:xxx/xxx.git
git status	查看本地文件状态（修改 / 未暂存 / 已暂存）	git status
git log	查看提交历史（按 q 退出）	git log（简洁版：git log --oneline）

2. 分支操作（Gitee 多分支开发核心）

命令	作用	示例
git branch	查看本地分支（* 标记当前分支）	git branch
git branch -r	查看远程分支	git branch -r
git branch <分支名>	创建本地分支	git branch dev
git checkout <分支名>	切换分支	git checkout dev
git checkout -b <分支名>	创建并切换分支（常用）	git checkout -b feature/login
git branch -d <分支名>	删除本地分支（需先切换到其他分支）	git branch -d dev
git push origin -d <分支名>	删除远程分支	git push origin -d dev
git merge <分支名>	合并指定分支到当前分支	git merge dev（把 dev 合并到当前分支）

3. 提交 / 推送 / 拉取（核心操作）

命令	作用	示例
git add <文件/目录>	添加文件到暂存区	git add .（所有文件）/ git add src/（指定目录）
git commit -m "说明"	提交暂存区到本地版本库	git commit -m "修复登录页bug"
git commit --amend	修改最后一次提交说明（未推送前）	-
git push <远程别名> <分支名>	推送本地代码到远程	git push origin master
git pull <远程别名> <分支名>	拉取远程代码并合并到本地	git pull origin front
git fetch	拉取远程分支信息（不合并，仅更新本地远程分支引用）	git fetch origin

4. 远程仓库管理

命令	作用	示例
git remote -v	查看关联的远程仓库地址	git remote -v
git remote add <别名> <地址>	添加远程仓库	git remote add origin 仓库地址
git remote remove <别名>	删除关联的远程仓库	git remote remove origin
git remote rename <旧别名> <新别名>	重命名远程仓库别名	git remote rename origin gitee
git remote show <别名>	查看远程仓库详细信息	git remote show origin

5. 撤销 / 回滚（新手慎用，确认后操作）

命令	作用	示例
git restore <文件>	撤销工作区文件修改（恢复到上一次提交状态）	git restore src/App.vue
git restore --staged <文件>	撤销暂存区文件（回到工作区）	git restore --staged README.md
git reset --hard <提交ID>	回滚到指定提交版本（清空工作区 / 暂存区修改）	git reset --hard 1234567（提交 ID 从 git log 获取）
git revert <提交ID>	撤销指定提交（生成新提交，保留历史，更安全）	git revert 1234567

总结

核心流程：初始化Git → 暂存文件 → 本地提交 → 关联远程 → 推送；常用命令优先掌握：git status、git add、git commit、git push、git pull、git branch，其余命令按需查阅即可