“删除多模块旧文件”不能靠右键 Delete 解决，因其仅调用系统 API 删除路径，不识别模块边界、旧文件定义（如未被 Git 跟踪或无引用）及跨模块依赖，易致运行时错误。
为什么“删除多模块旧文件”不能靠右键 Delete 解决
PhpStorm 的右键 Delete 只是调用系统 API 删除路径，它不感知“模块边界”、不识别“旧文件”的定义（比如未被 Git 跟踪、未被任何 require 引用、或超过 30 天未修改），更不会跨模块分析依赖关系。你在一个模块里删了 Helper.php，其他模块里硬编码的 require 'modules/old/Helper.php' 不会报错，直到运行时才 Warning: failed to open stream。
先确认哪些文件真该删：用 Git + 文件系统双校验
别凭印象删。真实项目中，“旧”必须有可验证依据：
- 已从 Git 中移除但本地仍残留：
git status --ignored查出ignored项，再结合git ls-files --deleted看哪些曾被跟踪却已删库记录 - 从未被 Git 跟踪且无引用：用
find . -type f -not -path "./vendor/*" -not -path "./.git/*" -not -name "*.php" | xargs -I{} sh -c 'echo {}; grep -l "{}" **/*.php 2>/dev/null | head -1'快速筛出零引用的非 PHP 文件（注意路径需按实际调整） - 修改时间早于某阈值：如清掉 modules/v1/ 下所有 90 天前的
.php文件，用find modules/v1 -name "*.php" -mtime +90 -print先预览，确认无误再加-delete
删之前必须锁定三类关键路径
多模块结构下，以下目录删错会导致整个项目启动失败或 CI 崩溃：
-
.idea/modules.xml和各模块下的.iml文件：它们定义模块依赖和源码根，删了 PhpStorm 会丢失模块识别，Mark Directory as → Sources Root都救不回来 -
composer.json中autoload映射路径（如"App\V1\": "modules/v1/src/"）：对应目录若被删，composer dump-autoload会报错，不是文件不存在，而是映射失效 - 各模块内的
config/、migrations/、fixtures/：这些常含空目录占位符（如.gitkeep），删空后 Git 会丢掉整个目录，下次拉代码直接缺失
安全批量删的实操路径
没有“一键”，只有分层执行：
立即学习“PHP免费学习笔记（深入）”；
- 第一层：删 Git 已忽略且无引用的文件 → 在 PhpStorm 终端跑：
git clean -fdX --dry-run预览，确认无误后换-f - 第二层：删指定模块内过期日志/缓存 → 如
rm -rf modules/v1/cache/* modules/v1/logs/*.log，注意避开.gitkeep，可用find modules/v1/logs -name "*.log" -not -name ".gitkeep" -delete - 第三层：删废弃模块目录本身 → 先手动删
modules/v1/，再立刻进File → Project Structure → Modules移除对应 module 条目，最后删掉.idea/modules/v1.iml，否则重启后 PhpStorm 会自动重建空目录
最易被忽略的是：模块间可能存在软链接（如 modules/v2/lib → ../v1/lib），删源目录前务必 ls -la 检查，否则会把其他模块一起拖垮。
