右键Delete不能安全清废弃文件，因PhpStorm仅调用系统API删路径，不检测引用、运行状态或构建依赖，易致CI失败、框架启动报错或资源404；需通过Find Usages、Git历史、git ls-files --deleted交叉验证，并按“查→筛→删→验”流程操作。
为什么右键 Delete 不能安全清掉废弃文件
PhpStorm 的 Delete 操作只是调用系统 API 删除路径，不判断文件是否被引用、是否还在运行、是否属于构建产物。你删掉 vendor/autoload.php，IDE 不会警告；删掉被 require_once 硬编码加载的 config/legacy.php，也不会提示“该文件仍在被使用”。它只管路径存在与否，不管语义。
常见错误现象包括：
- 删了
.env.example后 CI 构建失败——它本该保留用于初始化 - 删了
storage/framework/cache/data/下的缓存文件，结果 Laravel 启动报错（因目录结构被破坏） - 删了
public/build/但没删public/build.manifest.json，前端资源加载 404
怎么识别真正废弃的文件
不能靠“我感觉它没用了”，得靠可验证的依据。PhpStorm 本身不扫描引用关系，但你可以组合三类线索交叉确认：
-
Find Usages（Alt+F7）对类名、函数名、常量名查调用：如果返回空，且该文件无全局副作用（比如没写echo、file_put_contents），基本可判废弃 -
Git → Show History查该文件最近一次修改时间：超过 6 个月无变更 + 无 merge 记录，风险较低 - 终端执行
git ls-files --deleted：列出已从 Git 跟踪中移除但本地仍存在的文件——这些大概率是真废弃，删前可git clean -n -f预览
注意：vendor/、node_modules/、dist/ 这类目录别手动删文件，应走 composer install --no-dev 或 npm ci 重建。
立即学习“PHP免费学习笔记（深入）”；
安全删除的实操路径
别在 Project 工具窗口里批量勾选+Delete。正确顺序是“查→筛→删→验”：
- 先在 Terminal 中跑
find . -name "*.log" -o -name "*.tmp" -o -name "*.swp" | head -20快速预览匹配项，确认无误再加-delete - 要删整个废弃模块（如
app/Http/Controllers/LegacyApi/），先用grep -r "LegacyApi" app/ --include="*.php"确认无任何引用 - 删前备份关键路径：
tar -cf ~/legacy-backup-$(date +%s).tar app/Http/Controllers/LegacyApi/ - 删完立刻运行
php artisan config:clear && php artisan cache:clear（Laravel）或composer dump-autoload，验证是否引入断裂
容易被忽略的陷阱
最危险的不是删错文件，而是删错时机和上下文：
-
.gitignore里排除的文件（如storage/logs/*.log）可能被 IDE 当作“不可见文件”，右键根本点不到——得进 Terminal 删 - 某些框架生成的文件（如 Symfony 的
var/cache/dev/Container*/）有符号链接，直接删目录可能破坏容器结构 - Windows 下用 PhpStorm 内置 Terminal 执行
del /f /q，若路径含空格未加引号，命令会截断，只删了部分路径 - 删完别急着关 Terminal，用
ls -la确认目标确实消失，而不是因为权限问题静默失败
真正废弃的文件往往藏在 tests/fixtures/、docs/archived/、resources/assets/old/ 这些角落，它们不会出现在任何自动扫描里，只能靠人盯住 Git 历史和目录命名习惯去翻。
