JetBrains IDE 重构预览与批量应用

在 JetBrains IDE 里改一个公开方法名，真正需要确认的不是“能不能改”，而是哪些文件、调用点和接口实现会一起变化。稳妥的做法是从符号重构入口启动 Preview，在 Refactoring Preview 中按文件或用法类型检查，再用 Do Refactor 一次性应用保留下来的结果。

官方地址：https://www.jetbrains.com/idea/

把 Preview 当成一次可筛选的变更清单：先确认范围，再排除不应修改的项，最后批量应用。普通文本替换适合改字面量，方法、类、包和接口成员则应优先使用结构化重构。

从符号入口启动重构预览

先把光标放到要改名的类、方法、字段或包上，按 Shift+F6，或者从右键菜单进入 Rename。输入新名称后，不要直接按 Refactor；在对话框里选择 Preview。Move、Change Signature 等支持预览的重构也使用同样思路。

预览与普通搜索替换的差别在于，IDE 会根据项目索引识别声明、调用、导入、继承关系等代码用法。比如把 OrderService.load() 改名时，真正需要关注的是方法调用和接口实现，而不是所有恰好出现相同字符的注释。

在 Refactoring Preview 看清影响范围

选择 Preview 后，结果会出现在 Find 工具窗口的 Refactoring Preview 标签中。先看顶部的项目范围和结果数量，再展开目录、模块或文件节点。不同 IDE 或重构类型的分组会略有差异，但判断顺序可以保持不变：先确认声明是否在结果里，再看调用点、接口实现、导入和测试代码是否覆盖。

Find 工具窗口还可以按文件结构、模块、包或用法类型分组。遇到一个名字在注释、字符串或资源文件里也出现的情况，不要把它们与代码引用混为一谈；是否纳入这些文本结果，应由重构对话框中的搜索选项和当前任务决定。

查看单个结果时，可以打开预览窗格或跳转源文件。预览的价值不是让你逐行阅读整个项目，而是快速发现两个高风险信号：结果跑出了预期模块，或者接口/测试中的引用没有被纳入。

排除误选后批量应用

确认结果后，对不应修改的节点使用 Exclude。常见例子是：只改生产模块，不改一份暂存示例；保留某个外部兼容文本；或者把一次重构限定在当前模块。被排除的项目会保留在结果树中并以排除状态显示，执行批量应用时不会被修改。

筛选完成后点击 Do Refactor，IDE 会对当前结果统一应用重构。应用前再检查一次作用域、目标名称和排除数量，尤其是接口方法、公共类和跨模块包移动，这些对象往往比局部变量影响更多文件。

应用后不要把“文本变了”当成完成。可以在变更视图里按文件扫一遍，重点查看接口实现、测试、配置引用和导入；如果项目有编译或测试入口，再把它们作为后续的工程检查。本文的重点是预览与批量应用边界，不把 IDE 的预览结果当成编译成功证明。

预览不合适时怎么取消或回退

如果结果树明显超出预期，直接点击 Cancel 关闭预览，不要为了“先改了再说”而提交。重新执行时缩小 Scope，或在重构对话框中关闭不需要的搜索选项，再生成一份新的预览。

如果已经应用并发现误选，可以用 Ctrl+Z 撤销本次重构，再检查撤销范围是否对应刚才的批量操作。撤销后不要继续叠加第二次重构；先回到稳定状态，重新预览并只保留需要的结果。

速查表和常见误区

为什么 Preview 不是普通的查找结果？因为它围绕重构对象组织代码用法，能够按声明、调用和模块等关系查看；普通查找更适合定位字面量。

能不能只应用部分结果？可以，在 Refactoring Preview 中排除不需要的节点，再执行 Do Refactor；关键是应用前确认剩余树仍覆盖必要引用。

重构后如何撤销？使用 Ctrl+Z 回退本次变更，然后缩小作用域或调整选项重新预览。