一、文件删除策略1. Safe delete (with usage search) 安全删除检索引用作用删除文件前全局扫描项目所有代码查找是否有地方引用了这个文件Java 类import 导入、实例化、继承、注解引用等md / 配置文件代码里读取该文件路径、硬编码文件名引用资源文件xml、yml 中导入、静态资源加载两种情况找到引用弹窗列出所有使用位置不让你直接删避免代码报找不到文件报错无任何引用直接执行删除。不勾选此选项跳过引用检查直接删除文件哪怕代码里还在调用它后续编译 / 运行会抛异常。2. Search in comments and strings 在注释和字符串中检索依赖「Safe delete」开启才生效是安全删除的补充检索规则开启勾选检索范围包含代码注释// PROPERTY_API_DOCUMENTATION.md字符串字面量String path PROJECT_API_DOCUMENTATION.md;只要注释 / 字符串里出现文件名就判定为存在引用阻止删除。关闭取消勾选只检索功能性代码引用import、文件读取 API、资源导入标签等忽略注释、普通文本字符串。 适用场景只是注释里提过文件名实际代码没有使用想直接删掉文件。组合策略推荐组合 1两个都勾选图中默认最稳妥适合绝大多数开发场景彻底排查所有显性、隐性引用删文件不会遗留无效代码。组合 2只勾选 Safe delete取消 Search in comments and strings注释 / 文案只是备注文件名代码无实际读取逻辑不想被注释干扰删除操作。组合 3两个都不勾选直接物理删除文件不做任何引用检查适合确定文件完全废弃、无任何代码关联追求快速删除。补充物理删除位置点 OK 删除后本地文件移入系统回收站Git 项目中文件标记为待删除提交后才会从版本库移除。二、文件重命名操作1、左侧复选框组1. Search in comments and strings含义在代码注释、字符串字面量里同步替换类名文本例子// PersonController 提供人员接口 String name PersonController;勾选后注释、字符串里的PersonController也会一并改名不勾选则只改代码逻辑引用。2. Rename tests含义同步重命名测试类 / 测试方法场景如果有PersonControllerTest测试类勾选后测试类名、内部引用全部同步修改不勾选测试代码保持原名。3. Rename variables含义重命名所有引用该类的变量、字段、形参例子private PersonController personController; public void test(PersonController controller){}勾选后变量、参数的类型会同步更新取消则仅改类文件本身变量类型报错。2、右侧复选框组1. Search for text occurrences含义全局纯文本检索匹配项目所有文件yml、xml、md、sql 等配置文件里的类名字符串都会被替换风险提醒如果 yml、日志、注释里有无关文本和类名重名会误改仅单纯改 Java 代码时可取消。2. Rename inheritors含义同步重命名子类、实现类场景如果有class PersonControllerChild extends PersonController勾选后子类内所有父类引用同步更新取消会导致子类继承报错。3、Scope作用域Project Files默认范围整个项目所有文件执行替换下拉可切换仅当前文件 / 当前模块 / 自定义目录右侧...按钮手动筛选包含 / 排除文件夹。4、底部操作按钮Preview预览点击后弹出窗口展示所有将要被修改的文件、代码行可手动取消不需要改动的条目推荐改名前先预览避免误改配置 / 注释。Refactor蓝色确认按钮确认执行全局重命名重构一次性替换所有勾选范围内的内容。Cancel取消本次重命名操作不做任何修改。5、业务使用建议你的后端项目场景只改 Java 代码不想动 yml、sql 里的文本取消Search for text occurrences不想修改注释、日志字符串取消Search in comments and strings存在单元测试、子类保留Rename tests、Rename inheritors勾选任何改名操作优先点Preview核对改动范围再点 Refactor
IDEA文件删除策略和文件重命名操作（包含各选项讲解以及策略选择）
发布时间：2026/7/22 15:27:13
一、文件删除策略1. Safe delete (with usage search) 安全删除检索引用作用删除文件前全局扫描项目所有代码查找是否有地方引用了这个文件Java 类import 导入、实例化、继承、注解引用等md / 配置文件代码里读取该文件路径、硬编码文件名引用资源文件xml、yml 中导入、静态资源加载两种情况找到引用弹窗列出所有使用位置不让你直接删避免代码报找不到文件报错无任何引用直接执行删除。不勾选此选项跳过引用检查直接删除文件哪怕代码里还在调用它后续编译 / 运行会抛异常。2. Search in comments and strings 在注释和字符串中检索依赖「Safe delete」开启才生效是安全删除的补充检索规则开启勾选检索范围包含代码注释// PROPERTY_API_DOCUMENTATION.md字符串字面量String path PROJECT_API_DOCUMENTATION.md;只要注释 / 字符串里出现文件名就判定为存在引用阻止删除。关闭取消勾选只检索功能性代码引用import、文件读取 API、资源导入标签等忽略注释、普通文本字符串。 适用场景只是注释里提过文件名实际代码没有使用想直接删掉文件。组合策略推荐组合 1两个都勾选图中默认最稳妥适合绝大多数开发场景彻底排查所有显性、隐性引用删文件不会遗留无效代码。组合 2只勾选 Safe delete取消 Search in comments and strings注释 / 文案只是备注文件名代码无实际读取逻辑不想被注释干扰删除操作。组合 3两个都不勾选直接物理删除文件不做任何引用检查适合确定文件完全废弃、无任何代码关联追求快速删除。补充物理删除位置点 OK 删除后本地文件移入系统回收站Git 项目中文件标记为待删除提交后才会从版本库移除。二、文件重命名操作1、左侧复选框组1. Search in comments and strings含义在代码注释、字符串字面量里同步替换类名文本例子// PersonController 提供人员接口 String name PersonController;勾选后注释、字符串里的PersonController也会一并改名不勾选则只改代码逻辑引用。2. Rename tests含义同步重命名测试类 / 测试方法场景如果有PersonControllerTest测试类勾选后测试类名、内部引用全部同步修改不勾选测试代码保持原名。3. Rename variables含义重命名所有引用该类的变量、字段、形参例子private PersonController personController; public void test(PersonController controller){}勾选后变量、参数的类型会同步更新取消则仅改类文件本身变量类型报错。2、右侧复选框组1. Search for text occurrences含义全局纯文本检索匹配项目所有文件yml、xml、md、sql 等配置文件里的类名字符串都会被替换风险提醒如果 yml、日志、注释里有无关文本和类名重名会误改仅单纯改 Java 代码时可取消。2. Rename inheritors含义同步重命名子类、实现类场景如果有class PersonControllerChild extends PersonController勾选后子类内所有父类引用同步更新取消会导致子类继承报错。3、Scope作用域Project Files默认范围整个项目所有文件执行替换下拉可切换仅当前文件 / 当前模块 / 自定义目录右侧...按钮手动筛选包含 / 排除文件夹。4、底部操作按钮Preview预览点击后弹出窗口展示所有将要被修改的文件、代码行可手动取消不需要改动的条目推荐改名前先预览避免误改配置 / 注释。Refactor蓝色确认按钮确认执行全局重命名重构一次性替换所有勾选范围内的内容。Cancel取消本次重命名操作不做任何修改。5、业务使用建议你的后端项目场景只改 Java 代码不想动 yml、sql 里的文本取消Search for text occurrences不想修改注释、日志字符串取消Search in comments and strings存在单元测试、子类保留Rename tests、Rename inheritors勾选任何改名操作优先点Preview核对改动范围再点 Refactor
