常见问题

IDEA 使用更新项目操作

在使用 IntelliJ IDEA 进行 Git 操作时，更新项目时会出现如下两个选项：

1. Update Project（普通合并 merge）：将远程分支上的最新代码拉取到本地，然后将本地分支与远程分支合并。如果有冲突，需要手动解决。这种方式会生成一个新的合并提交，保留了本地分支和远程分支的所有提交历史。

2. Update Project with Rebase（变基 rebase）：将本地分支上的所有提交临时保存，然后把远程分支的最新代码拉取到本地，再将本地提交重新基于远程最新提交之上。如果有冲突，需要手动解决。这种方式会重写本地提交历史，使提交记录呈线性。

建议：多人协作时优先使用普通合并（merge），避免 rebase 重写历史影响他人。只在个人开发分支上整理提交历史时使用 rebase。

代码提交到本地仓库或者推送到远程仓库的话，还能回滚吗？能回滚的话，回滚命令是什么？

如果你已经将代码提交到本地仓库或远程仓库，你仍然可以回滚代码更改。回滚操作可以还原到之前的提交状态，撤销先前的更改。

下面是一些常用的回滚命令：

1. 回滚到上一次提交：

   git revert HEAD
   

2. 回滚到指定提交（使用提交哈希值）：

   git revert <commit-hash>
   

3. 回滚到指定提交并将后续提交合并为一个新的提交：

   git revert <commit-hash>..HEAD
   

这些命令会创建一个新的提交，该提交会撤销指定的更改。请注意，这些命令会创建一个新的提交，而不是直接删除或修改历史提交记录。

如果你要回滚到之前的提交，并且希望删除回滚之后的提交记录，可以使用 git reset 命令。但是，请注意，git reset 命令会修改历史提交记录，因此在使用之前请确保你了解其影响。

如果你已经将代码推送到远程仓库，回滚后可能需要使用 git push 命令将回滚提交推送到远程仓库。

请注意，git revert 是安全的操作（创建新提交来撤销更改，不修改历史），而 git reset --hard 会修改历史提交记录，执行前请确保已备份重要更改。对于已推送到远程的提交，优先使用 git revert 而非 git reset。

代码已经提交并推送到了远程仓库，此时撤销提交会发生什么？

如果你已经将代码提交并推送到远程仓库，但后来想要撤销该提交。以下是一些可能的情况：

1. 提交还没有被其他人拉取（fetch/pull）：
   • 如果你的提交已经推送到远程仓库，但其他人还没有拉取，你可以使用 git reset 或 git revert 来撤销提交。这不会影响其他人的工作。
   • 使用 git reset 会将HEAD指针移动到以前的提交，将历史记录修改为不包含该提交。但是，这会删除提交的历史记录，可能会导致冲突。
   • 使用 git revert 会创建一个新的提交，该提交撤销了以前的提交，保留了历史记录。这是更安全的方法，因为不会破坏历史记录。
2. 提交已经被其他人拉取：
   • 如果你的提交已经被其他人拉取到远程仓库，撤销提交可能会引发问题，因为其他人可能已经构建了基于你的提交的工作。在这种情况下，最好不要直接撤销提交，而是与团队协商，找出一个解决方案。
3. 其他团队成员修改代码后并推送到远程仓库：
   • 在这种情况下，如果你强行撤销自己的提交并强制推送到远程仓库，会导致其他人的工作受到影响，可能会引发冲突和一致性问题。
   • 如果一定要撤销已推送的提交，最好与团队一起协商解决，以避免引发问题。

已经推送到远程仓库，但还没被人拉取的情况

如果你的提交已经被推送到远程仓库，但尚未被其他人拉取，你可以使用以下步骤来撤销该提交：

注意： 这个过程将修改你的本地历史记录，因此如果你正在与其他人协作，最好与他们协商并确保其他人知道你要执行这个操作。

1. 查看提交历史： 使用以下命令查看提交历史，找到你想要撤销的提交的哈希值（SHA-1）：

   git log
   

2. 撤销提交： 使用以下命令来撤销提交，将 <commit-hash> 替换为你想要撤销的提交的哈希值：

   git reset --hard <commit-hash>
   

   这将将你的 HEAD 指针和工作目录还原到指定提交的状态，同时删除了该提交之后的所有提交。

3. 强制推送到远程仓库： 由于你已经修改了历史记录，你需要使用 --force（或-f）选项来强制推送到远程仓库：

   git push --force origin <branch-name>
   

   其中，<branch-name> 是你当前工作的分支名称。

请注意，强制推送可能会破坏其他人的工作副本，因此在执行此操作之前，请确保你已与团队协商，以确保不会引发问题。

此外，由于这个操作可能会删除历史记录，只有在你确定没有其他人在使用这个历史记录或有备份的情况下才应该执行。

克隆含子模块的项目后，子模块目录是空的？

原因：普通 git clone 不会自动拉取子模块。

解决：

# 方式一：克隆时加参数
git clone --recurse-submodules <仓库地址>

# 方式二：已克隆的项目，手动初始化
git submodule update --init --recursive

详见 Git Submodule 子模块管理。

子模块提交了代码，但主仓库没有更新？

原因：子模块代码提交后，还需要在主仓库提交一次"指针更新"。

解决：

# 1. 先在子模块内提交并推送
cd backend
git add -A
git commit -m "feat: xxx"
git push

# 2. 回到主仓库，提交子模块指针更新
cd ..
git add backend
git commit -m "chore: bump backend submodule"
git push

主仓库只记录子模块指向的 commit hash，子模块内部提交后，主仓库需要额外提交一次来记录新的 hash。

子模块处于 detached HEAD 状态？

原因：子模块默认指向某个具体的 commit，不在任何分支上。

解决：

cd backend
git checkout <分支名>
# 之后正常开发提交

开发前记得先切到分支，否则提交会丢失（在 detached HEAD 上的提交不在任何分支上，切换分支后可能找不到）。

Fork 的项目如何同步原仓库的更新？

解决：配置 upstream 远程，定期 fetch + merge。

# 1. 添加上游远程（只需一次）
git remote add upstream <原仓库地址>

# 2. 拉取上游更新
git fetch upstream

# 3. 合并到 master
git checkout master
git merge upstream/master
git push origin master

# 4. 合并到开发分支
git checkout <开发分支>
git merge master
git push origin <开发分支>

详见 Fork 工作流与上游同步。

.gitignore 不生效？

原因：文件已经被 Git 跟踪，.gitignore 只对未跟踪的文件生效。

解决：

# 从 Git 索引中移除（不删除本地文件）
git rm --cached <文件或目录>

# 提交
git commit -m "chore: 移除不应跟踪的文件"

详见 .gitignore 最佳实践。

学习参考

• 开发不害怕——两种常见的撤销提交的方式（Git） - 掘金 (juejin.cn) (opens new window)