git stash "本地代码不见了"

前言

由于刚开始对git stash命令理解不透彻，误以为代码不见了，所以记录一下git stash的使用以及过程中遇到的坑😄（stash文件和本地UserInterfaceState.xcuserstate冲突，无法stash pop）

git stash的应用场景

当正在dev分支上开发某个项目，这时项目中出现一个bug，需要紧急修复，但是正在开发的内容只是完成一半，还不想提交，这时可以用git stash命令将修改的内容保存至堆栈区，然后顺利切换到hotfix分支进行bug修复，修复完成后，再次切回到dev分支，从堆栈中恢复刚刚保存的内容
由于疏忽，本应该在dev分支开发的内容，却在master上进行了开发，需要重新切回到dev分支上进行开发，可以用git stash将内容保存至堆栈中，切回到dev分支后，再次恢复内容即可

总的来说，git stash命令的作用就是将目前还不想提交的但是已经修改的内容进行保存至堆栈中，后续可以在某个分支上恢复出堆栈中的内容。这也就是说，stash中的内容不仅仅可以恢复到原先开发的分支，也可以恢复到其他任意指定的分支上。git stash作用的范围包括工作区和暂存区中的内容，也就是说没有提交的内容都会保存至堆栈中。

命令

git stash 或 git stash save ""

执行git stash前目录结构

执行git stash后目录结构

可以看到test.swift文件不见了，git stash 能够将所有未提交的修改（工作区和暂存区）保存至堆栈中，用于后续恢复当前工作目录

git stash list

rhp$ git stash list
stash@{0}: WIP on thirdIss: 0624f25 删除stash命令测试文件
rhpdembp:ToyStory rhp$

查看当前stash中的内容

git stash pop

rhpdembp:ToyStory rhp$ git stash pop
On branch thirdIss
Your branch is up to date with 'origin/thirdIss'.

Changes not staged for commit:
  (use "git add <file>..." to update what will be committed)
  (use "git checkout -- <file>..." to discard changes in working directory)

    modified:   ToyStory.xcodeproj/project.pbxproj

Untracked files:
  (use "git add <file>..." to include in what will be committed)

    test.swift

no changes added to commit (use "git add" and/or "git commit -a")
Dropped refs/stash@{0} (d46cdf62251c21e5eceffbf092c49fb60ed9a501)
rhpdembp:ToyStory rhp$

这时候会看到test.swift文件恢复了，git stash pop将当前stash中的内容弹出，并应用到当前分支对应的工作目录上。
注：该命令将堆栈中最近保存的内容删除（栈是先进后出）

git stash apply

将堆栈中的内容应用到当前目录，不同于git stash pop，该命令不会将内容从堆栈中删除，也就说该命令能够将堆栈的内容多次应用到工作目录中，适应于多个分支的情况。

git stash drop + 名称

从堆栈中移除某个指定的stash

git stash clear

清除堆栈中的所有内容

git stash show

查看堆栈中最新保存的stash和当前目录的差异

git stash show -p

查看堆栈中最新保存的stash和当前目录的差异的详细内容

git stash branch

从最新的stash创建分支。
应用场景：当储藏了部分工作，暂时不去理会，继续在当前分支进行开发，后续想将stash中的内容恢复到当前工作目录时，如果是针对同一个文件的修改（即便不是同行数据），那么可能会发生冲突，恢复失败，这里通过创建新的分支来解决。可以用于解决stash中的内容和当前目录的内容发生冲突的情景。发生冲突时，需手动解决冲突。

恢复stash内容的坑：

git stash 后切换到其它分支再回来, 因为Git 没有设置忽略UserInterfaceState.xcuserstate文件，（UserInterfaceState.xcuserstate这个文件一直在自动更新，即使我的代码没改变，提交时也有它。后来百度到这是Xcode自带的文件，不应该被提交到版本管理中），导致git stash pop 提示冲突，疯狂百度也没能解决问题，最后无意发现执行git stash clear 后，本地目录的文件都回来了，不知道为什么，知道原来的可以底下留言，谢谢

扩展：
gitignore配置
 git stash详解

特别感谢以上朋友的技术分享