如何使用git上传本地代码到远程的gitee仓库

参考文章：如何使用git上传本地代码到远程的gitee仓库_如何将本地git代码推送到gitee-优快云博客

前提准备（必做）

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（全新代码文件夹）

# 步骤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 文件夹）

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

# 步骤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），无法推送」：

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

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