如果希望将 docs 文件夹完全切换为 master 分支的状态，即：
✅ 删除 master 中不存在的文件
✅ 增加 master 中才有的文件
✅ 恢复 master 分支中的所有文件（如果本地有改动，也要覆盖）
你可以使用以下方法：
方法 1：使用 git checkout + git clean
git checkout master -- ./docs
git clean -df ./docs
解释：
git checkout master -- ./docs- 将
master分支的docs目录检出到当前分支，会覆盖已有的相同文件，但不会删除当前分支多余的文件。
- 将
git clean -df ./docs- 删除 master 没有的文件或目录（
-d代表目录，-f强制删除）。
- 删除 master 没有的文件或目录（
方法 2：使用 git reset --hard
⚠ 注意：此方法会丢失 docs 目录下的所有本地改动，谨慎使用！
git fetch origin # 确保本地获取最新的 master 分支
git reset --hard origin/master -- ./docs
解释：
git reset --hard origin/master -- ./docs- 彻底将
docs目录重置为origin/master的版本， - 删除本地改动，恢复
master上的状态。
- 彻底将
方法 3：删除并重新检出
如果 docs 目录的改动很混乱，直接删除然后重新检出：
rm -rf ./docs # 删除整个 docs 目录
git checkout master -- ./docs # 重新检出 master 的 docs 目录
优点：彻底清除本地所有文件，确保 docs 目录和 master 完全一致。
缺点：如果 docs 目录很大，可能影响性能。
方法 4：切换到 master 并重新创建分支
如果你当前的分支不重要，可以直接切回 master 并重新创建分支：
git checkout master
git checkout -b new-branch
这样 docs 目录就和 master 完全一致了。
哪种方法最好？
- 如果有未提交改动，且不想丢失 → 方法 1 (
checkout+clean) - 如果不介意丢失所有改动 → 方法 2 (
reset --hard) - 如果想彻底清理后重新检出 → 方法 3 (
rm -rf+checkout) - 如果可以重建分支 → 方法 4 (直接
checkout master)
如果你不确定是否有未提交的改动，建议先运行：
git status
如果有未提交的改动，先 git stash 备份，然后再操作：
git stash
# 运行上述操作
git stash pop # 取回之前的改动（可选）
这样可以避免误删重要文件。
如果你希望 先切换 docs 目录到 master 的状态，然后再切换回当前分支的状态，可以按照以下步骤操作：
方法 1：使用 git stash（推荐）
如果 docs 目录的改动较多，最安全的方法是 先存储当前分支的 docs 目录状态，切换后再恢复：
# 1. 仅存储当前分支 `docs` 目录的修改
git stash push -m "Save docs before switching" -- docs# 2. 切换 `docs` 目录到 master 分支的状态
git checkout master -- docs
git clean -df docs # 删除 master 中没有的文件# 3. 确保 `docs` 目录为 master 分支的最新状态
git reset --hard origin/master -- docs# ...（你可以在此时使用 master 版本的 docs 做你的操作）# 4. 恢复当前分支 `docs` 目录的状态
git stash pop
✅ 优点：
- 这不会影响
docs之外的文件。 stash让你可以随时恢复当前分支的docs目录状态。
方法 2：使用临时分支
如果你只是想临时切换到 master 版本的 docs，然后再回到当前分支：
# 1. 记录当前分支名称（假设当前分支是 feature-branch）
CURRENT_BRANCH=$(git rev-parse --abbrev-ref HEAD)# 2. 切换 `docs` 目录到 master
git checkout master -- docs
git clean -df docs# ...（此时你可以操作 master 的 docs 目录）# 3. 切换回原来的分支，并恢复 docs
git checkout $CURRENT_BRANCH
git checkout $CURRENT_BRANCH -- docs
✅ 适用于：
- 你想在当前分支临时使用
master的docs，但不想用stash。
方法 3：直接切换回当前分支
如果 docs 目录的改动不大，你可以直接切回当前分支，这样 docs 目录就会恢复：
# 记录当前分支
CURRENT_BRANCH=$(git rev-parse --abbrev-ref HEAD)# 切换 `docs` 目录到 master
git checkout master -- docs
git clean -df docs# 切换回当前分支
git checkout $CURRENT_BRANCH
不过这样 不会恢复 docs 目录的本地修改，如果你想恢复，请使用 方法 1（stash）。
总结
| 方法 | 适用场景 | 是否安全 |
|---|---|---|
git stash | docs 目录改动较多，希望恢复 | ✅ 最安全 |
临时分支 | 需要临时切换 docs，然后恢复 | ⚠️ 可能有冲突 |
直接切回当前分支 | 改动较少 | ❌ 可能丢失修改 |
如果不确定，推荐方法 1（git stash），可以安全存储 docs 目录的改动，避免误删重要文件！🚀
 "类和对象(下)")
