Git相关

一：Git仓库初始化

要将 IDEA 中的项目推送到指定的 Gitee 仓库，需按**「初始化本地 Git → 关联远程仓库 → 提交代码 → 推送」**的流程操作，以下是详细步骤：

1：在 Gitee 创建空仓库

登录 Gitee，点击右上角 「+」→「新建仓库」 ，填写仓库名称、描述等信息（注意：不要勾选「初始化仓库」（如添加 README），避免与本地项目冲突），点击「创建」。

---

2：IDEA 中初始化本地 Git 仓库

打开 IDEA 的终端（View → Tool Windows → Terminal），执行以下命令初始化本地 Git 仓库：

git init

---

3：关联 Gitee 远程仓库

获取 Gitee 仓库的 HTTPS/SSH 地址 （仓库页面右上角「克隆/下载」按钮处复制），然后在 IDEA 终端执行 git remote add 命令关联远程仓库：

# HTTPS 方式（推荐新手）
git remote add origin https://gitee.com/你的用户名/你的仓库名.git

# SSH 方式（需提前配置 SSH Key，适合熟练用户）
git remote add origin git@gitee.com:你的用户名/你的仓库名.git

---

4：将项目文件添加到 Git 暂存区

执行 git add . 将当前目录下所有文件（包括 .idea 等配置文件，若不想提交可后续用 .gitignore 过滤）添加到暂存区：

git add .

---

5：首次提交代码到本地仓库

执行 git commit 命令提交暂存区的文件，并添加提交说明：

git commit -m "first commit"

---

6：推送代码到 Gitee 远程仓库

执行 git push 将本地代码推送到 Gitee 仓库。由于是首次推送，需指定分支（默认 master，部分新仓库可能为 main，需根据 Gitee 仓库实际分支调整）：

# 推送到 master 分支（多数情况）
git push -u origin master

# 若 Gitee 仓库默认分支是 main，则执行
git push -u origin main

---

7：额外注意事项

• .gitignore 配置 ：Java 项目中，建议添加 .gitignore 文件忽略不必要的文件（如编译产物、IDE 配置）。示例内容

  # 编译产物
  target/
  *.class
  
  # IDEA 配置（可选，按需保留）
  .idea/
  *.iml
  
  # Maven 依赖缓存
  .m2/repository/

  添加后需重新执行 git add . 和 git commit 使其生效。

• 权限问题：若推送时提示认证失败，检查 Gitee 账号密码是否正确；若用 SSH 方式，需确保已配置 SSH Key 并添加到 Gitee 账户。

完成以上步骤后，刷新 Gitee 仓库页面，即可看到推送的项目代码。

---

8：处理push失败

git push -u origin master
To https://gitee.com/zhang_xiaosong/ai.git
 ! [rejected]        master -> master (fetch first)
error: failed to push some refs to 'https://gitee.com/zhang_xiaosong/ai.git'
hint: Updates were rejected because the remote contains work that you do
hint: not have locally. This is usually caused by another repository pushing
hint: to the same ref. You may want to first integrate the remote changes
hint: (e.g., 'git pull ...') before pushing again.
hint: See the 'Note about fast-forwards' in 'git push --help' for details.

这个错误是因为 远程仓库（Gitee）包含你本地没有的提交（commits），Git 为了防止你覆盖别人（或者之前生成的）代码，拒绝了你的推送。

---

8.1： 拉取远程代码并合并

执行 git pull 命令。由于是初次同步，建议使用 --allow-unrelated-histories 参数来允许合并两个不相关的历史记录（这是解决此类新建仓库冲突最直接的方法）。

git pull origin master --allow-unrelated-histories

• 预期情况 ：执行后，Git 会将远程的 README.md 等文件下载到你的本地，并自动尝试合并。
• 如果提示合并冲突：通常是因为双方都有 README 文件。如果你本地的 README 不重要，可以直接选择保留远程的版本，或者手动编辑解决冲突后保存。

---

8.2：解决合并（如有提示）

如果上一步出现了 CONFLICT 提示，你需要：

1. 手动打开并编辑有冲突的文件（如 README.md），删除特殊标记（<<<<<<<、=======、>>>>>>>）并保留你需要的内容。
2. 编辑完成后，执行 git add . 告诉 Git 冲突已解决。

---

8.3：再次推送代码

完成合并后，再次执行推送命令。此时本地的历史记录已经包含了远程的内容，Git 就不会再拒绝你的推送了。

git push -u origin master