IntelliJ IDEA Local History 怎么恢复未提交的目录

IntelliJ IDEA 里一个未提交目录被误删后，恢复入口通常不在 Git，而在 Local History。关键是：目录已经消失时，要选中它原来的父目录，进入 Local History | Show History，找到删除前仍包含该目录的修订，再对目标目录执行 Revert Selection。恢复完成的判断不是“弹窗消失”，而是目录重新出现在 Project 树、文件内容能打开，并且版本控制状态符合预期。

IntelliJ IDEA 官方帮助：https://www.jetbrains.com/help/idea/local-history.html

恢复后的正确结果应该是什么

假设被删的是 src/feature-report，里面有服务类、界面类和说明文件。理想结果是这三个文件随目录一起回到原位置，文件内容对应删除前的修订；删除之后在其他目录完成的新修改不应被整批回滚。

因此，这次操作要避免两个常见误区：一是对整个项目执行大范围 Revert，把无关的新修改也带回旧状态；二是先手工新建同名目录，再去查它自己的历史。目录不存在时，Local History 的观察入口是仍然存在的父节点。

第 1 步：选中被删目录原来的父目录

1. 打开左侧 Project 工具窗口；官方文档给出的快捷入口是 Alt+1，也可以直接点击工具窗口标签。
2. 展开项目树，找到目标目录删除前所在的父目录。本例应选中 src，而不是项目中另一个同名目录。
3. 右键父目录，依次选择 Local History | Show History。

此步的可见确认：屏幕上应出现 Local History 对话框，左侧有带时间信息的修订列表，而不是普通的 Git Log。如果打开的是 Git 历史，说明入口选错了。

第 2 步：定位删除前的修订

4. 在左侧修订列表中，从接近误删时间的位置开始查看。Local History 会记录 IDE 内外的有意义修改，因此从文件管理器删除的内容也可能出现在这里。
5. 逐个选择修订，观察变更项目或差异视图，直到看到 feature-report 目录及原有文件。
6. 选中目标目录，右键选择 Revert Selection。如果只想取回目录中的一个文件，可以只选择该文件，不必恢复整个父目录。

此步的可见确认：选中的修订里应明确出现目标目录及预期文件。若只看到一个空目录，继续切换到更早的修订；不要在没有确认内容的情况下对整个项目执行回滚。

第 3 步：核对目录和文件内容

7. 关闭或暂时移开 Local History 对话框，回到 Project 工具窗口，确认 feature-report 已重新出现在原来的 src 下。
8. 展开目录，逐个打开关键文件，检查类名、最近编辑片段、配置和资源文件是否完整。目录回来不代表每个文件都来自同一个正确时间点。
9. 打开版本控制的 Changes 视图。如果这些文件从未被 Git 跟踪，它们通常会显示为未版本控制；如果曾被跟踪，则应核对恢复后的修改差异。

最终验收标准：目录路径正确、关键文件数量与预期一致、文件内容可读、项目索引完成后没有因缺文件出现新的引用错误，同时其他目录在误删之后的修改仍然保留。

历史列表里找不到目录怎么办

先确认操作节点。被删目录的父目录如果也一起删除，应再向上选项目根节点查看历史。若项目在多个模块中存在相似路径，必须选中原模块，而不是只按目录名搜索。

其次考虑 Local History 的保存边界。官方说明指出，它受保留期和最大容量限制，修订并不保证永久存在；当前帮助页说明默认保存最近 5 个“有修改发生的工作日”。此外，安装新的 IntelliJ IDEA 版本会清除 Local History。若删除发生得很早、IDE 已升级，或 Local History 曾被禁用，列表中可能已经没有可恢复内容。

最后检查项目是否从未被 IDE 识别。Local History 不是磁盘级恢复工具：如果目录在 IDE 打开项目前就被创建并删除，或者被排除在项目之外且从未产生可记录状态，它可能没有历史。此时应转向备份、文件同步服务、系统快照或团队成员的副本，而不是重复点击同一个恢复动作。

只恢复了一部分文件怎么修正

部分恢复通常说明选中的修订太晚，或者只对某个文件执行了 Revert Selection。重新打开父目录的 Local History，选择更早且确实包含完整目录的修订，再对缺失文件执行精确恢复。不要为了补齐一个文件而回滚整个父目录，因为这可能覆盖同层其他文件的新修改。

若同一文件需要拼回多个时间点的代码，可在差异视图中选择包含目标片段的修订，使用箭头将特定内容复制回当前文件。这样比整文件回退更安全，也更符合“只恢复丢失部分”的目标。

恢复后如何避免再次丢失

• 先建立标签：大规模重构或批量删除前，通过 File | Local History | Put Label 给当前状态加一个有意义的名称。
• 及时纳入 Git：Local History 是本机个人恢复来源，不支持共享，也不等于长期版本控制。完成一个可运行节点后应提交到分支。
• 需要时调整保留期：可在 Settings 的 Advanced Settings 中找到 Local History 保存时长设置，但增加天数仍不能替代备份。
• 升级前先提交或备份：安装新的 IntelliJ IDEA 版本前，不要把唯一副本只留在 Local History。

相关问题

没有使用 Git，Local History 还能恢复吗

可以。Local History 独立于版本控制，官方明确说明即使项目尚未启用版本控制，也能用于恢复已删除文件和单独修改。但前提是对应状态仍保存在本机历史中。

从 Finder 或文件资源管理器删除的目录能恢复吗

有可能。Local History 会记录 IDE 内部以及外部产生的有意义项目修改。应在原父目录上查看历史；是否能恢复取决于该目录是否曾被记录且修订尚未过期。

Revert Selection 会把其他新修改一起撤销吗

对目标目录或文件执行精确的 Revert Selection，影响范围比回滚整个项目小。操作前仍应通过修订内容和差异视图确认选择对象，恢复后再检查 Changes 视图。

Local History 能代替 Git 吗

不能。它主要用于本机短期恢复，受保留期、容量和 IDE 升级影响，也不支持团队共享。Git、远程仓库和备份仍是长期保护代码的基础。