71 lines
2.2 KiB
Markdown
71 lines
2.2 KiB
Markdown
实际行为
|
||
当你在子模块有未提交的修改时执行 git submodule update：
|
||
cd thingsboard-client-demo
|
||
# 修改了一些文件，但没有 commit
|
||
|
||
cd ..
|
||
git submodule update
|
||
Git 会：
|
||
检测到子模块有未提交的修改
|
||
拒绝更新，并给出类似这样的错误：
|
||
error: Your local changes to the following files would be overwritten by checkout:
|
||
src/main/java/SomeFile.java
|
||
Please commit your changes or stash them before you switch branches.
|
||
Unable to checkout 'abc123' in submodule path 'thingsboard-client-demo'
|
||
为什么会这样？
|
||
git submodule update 本质上是在子模块中执行 git checkout <commit>。Git 的保护机制会阻止 checkout 覆盖未提交的修改。
|
||
不同场景
|
||
场景 1：未暂存的修改（modified）
|
||
cd thingsboard-client-demo
|
||
echo "test" >> file.txt # 修改文件，未 git add
|
||
|
||
cd ..
|
||
git submodule update
|
||
# ❌ 会报错，拒绝更新
|
||
场景 2：已暂存但未提交（staged）
|
||
cd thingsboard-client-demo
|
||
echo "test" >> file.txt
|
||
git add file.txt # 已暂存，但未 commit
|
||
|
||
cd ..
|
||
git submodule update
|
||
# ❌ 仍然会报错，拒绝更新
|
||
场景 3：新增的未跟踪文件（untracked）
|
||
cd thingsboard-client-demo
|
||
echo "test" > new-file.txt # 新文件，未 git add
|
||
|
||
cd ..
|
||
git submodule update
|
||
# ✅ 可以更新！因为新文件不会被覆盖
|
||
如何处理未提交的修改？
|
||
如果你确实需要更新子模块，有几个选择：
|
||
选项 1：提交修改
|
||
cd thingsboard-client-demo
|
||
git add .
|
||
git commit -m "临时修改"
|
||
git push # 如果需要保存到远程
|
||
|
||
cd ..
|
||
git submodule update
|
||
选项 2：暂存修改（stash）
|
||
cd thingsboard-client-demo
|
||
git stash # 暂存修改
|
||
|
||
cd ..
|
||
git submodule update
|
||
|
||
cd thingsboard-client-demo
|
||
git stash pop # 恢复修改
|
||
选项 3：放弃修改
|
||
cd thingsboard-client-demo
|
||
git checkout . # 放弃所有修改
|
||
git clean -fd # 删除未跟踪的文件
|
||
|
||
cd ..
|
||
git submodule update
|
||
总结
|
||
你的修改是安全的，Git 会保护你的工作：
|
||
有未提交修改时，git submodule update 会拒绝执行
|
||
你的修改不会丢失
|
||
你需要先处理这些修改（提交、暂存或放弃）才能更新子模块
|
||
这是 Git 的安全机制，防止意外覆盖你的工作成果。 |