当前位置：首页 > news >正文

Git | git stash命令详解

news 来源：原创 2025/7/3 22:37:14

`关注：CodingTechWork`

引言

在日常开发中，使用Git版本控制系统时，可能会遇到需要暂时中断当前工作，去处理其他任务的情况。这时，如果直接切换分支，可能会导致当前的修改未提交而丢失或需要暂时保存修改的状态。为了解决这个问题，Git提供了一个非常有用的命令：git stash。

Git Stash介绍

git stash命令的主要作用是将当前工作目录中的修改（暂存区和工作区）保存到一个栈中，然后将工作区恢复到与当前分支最新提交相同的状态。这样，你就可以自由地切换到其他分支，处理其他任务，等完成后再将之前的修改恢复回来。

git stash 基本用法

git stash

当你执行git stash时，Git会执行以下操作：

保存未暂存的修改：工作目录中的修改（未暂存）会被保存。
保存已暂存的修改：已添加到暂存区的修改（即通过git add命令暂存的文件）也会被保存。
恢复工作区的干净状态：工作目录和暂存区都将被恢复到最新提交的状态。

git stash 命令常见选项

git stash save `<message>`

git stash save "your message"

可以为stash添加一个描述性的信息，便于后续查看和管理。例如：

git stash save "WIP: Implement login feature"

这个命令会将修改保存到stash中，并给该stash加上一个标记“WIP: Implement login feature”。

git stash list

git stash list

查看当前所有的stash。输出的每一行都是一个stash记录，类似于：

stash@{0}: WIP on feature/login: a1b2c3d Implement login feature
stash@{1}: WIP on feature/search: d4e5f6g Add search feature

每个stash都有一个唯一的标识符（如stash@{0}），并且会列出该stash所在的分支、提交以及描述信息。

git stash show

git stash show

查看最新的stash所做的更改，默认只显示修改的文件名。输出结果可能类似于：

modified:   login.js
modified:   styles.css

如果需要查看具体的更改内容，可以使用-p（patch）选项：

git stash show -p

这将显示更改的详细差异内容（类似于git diff的输出）。

git stash apply

git stash apply stash@{0}

将指定的stash内容恢复到当前工作目录中，但是不会将该stash从stash栈中移除。stash@{0}代表最新的stash记录，你也可以指定其他的stash编号（如stash@{1}）。

git stash apply

如果没有指定stash标识符，默认会恢复最新的stash。

git stash pop

git stash pop

git stash pop与git stash apply类似，都会将stash中的更改应用到当前工作目录，但是与apply不同的是，pop会将该stash从stash栈中移除。使用pop时，如果发生冲突，可以通过Git的冲突解决机制进行处理。

git stash drop

git stash drop stash@{0}

删除指定的stash记录。这个操作是不可逆的，因此在删除之前需要谨慎确认。

git stash clear

git stash clear

删除所有的stash记录。此命令将清空所有的stash，确保你不再需要任何的stash内容后再执行该命令。

git stash branch `<branch-name>`

git stash branch feature/login-branch stash@{0}

这个命令会创建一个新的分支，基于stash中保存的状态恢复修改。执行完这个命令后，你会切换到新创建的分支，并将stash的修改应用到该分支上。执行完成后，原stash记录将被移除。

git stash的工作原理

git stash实际上是通过以下步骤来实现的：

保存当前工作区的修改：Git会将工作目录中的所有修改（包括未暂存的修改和暂存区中的修改）保存到一个“隐藏”区域中。
恢复到最新提交的状态：在保存修改之后，Git会将当前工作目录还原到最近一次提交的状态。
栈式存储：每次调用git stash，会将修改保存在一个栈结构中，最先保存的stash会排在栈的底部，最新保存的stash会排在栈顶。每次执行git stash apply或git stash pop时，Git会从栈顶取出一个stash并应用到当前的工作区。

stash与分支切换的结合

git stash非常适用于切换分支的场景。例如，你正在开发一个新功能，并且修改了某些文件，但突然需要切换到另一个分支去处理紧急的bug。如果你直接切换分支，当前的修改会阻止切换，因为这些修改未提交。此时，你可以使用git stash命令保存当前修改，再切换到目标分支，处理完紧急任务后再使用git stash pop恢复修改。

高级用法

stash与文件指定

如果你只想暂存某个特定的文件而不是所有文件，可以指定文件：

git stash push <file>

这种方式会将指定的文件变更保存到stash中，而不影响其他文件。

stash只保存暂存区的内容

有时，你可能只希望将已暂存的文件保存到stash中，而不包括工作目录中的未暂存文件。可以使用--staged选项：

git stash push --staged

此时，Git仅会将暂存区的内容保存到stash，而工作目录中的修改会保留。

git stash的最佳实践

清晰的注释：使用git stash save "message"时，提供清晰的描述信息，帮助日后回顾和管理不同的stash记录。
定期清理：虽然git stash是一个非常有用的工具，但积累过多的stash记录可能导致混乱。定期使用git stash list查看当前的stash，删除不再需要的记录（git stash drop 或 git stash clear）。
避免长期依赖stash：stash并非用于长期存储修改，它只是一个临时保存工作状态的工具。长期的开发工作最好是通过提交和分支管理来处理。

总结

Git的stash命令为开发人员提供了一个方便快捷的方式来保存临时的修改，以便进行分支切换或处理其他任务。通过使用git stash，我们可以有效地管理未提交的修改，避免数据丢失或混乱。

关注：CodingTechWork

引言