PhpStorm 无一键删除所有不需要代码的通用功能，需按类别分别处理：删未用变量/参数靠 Inspection 配置与全局扫描；删冗余 use 需开启保存时自动优化；删空行应避免正则误用，优先启用保存时自动清理。
PhpStorm 没有“一键删除所有不需要代码片段”的通用功能，所谓“不需要”必须由人定义——是未使用的变量、冗余的 use、空函数体、还是被注释掉的旧逻辑？不同类别得用不同机制处理，混用会误删。
删未使用的 PHP 变量和参数：靠 Inspection 配置 + 全局扫描
静态分析能标出大部分真正没被读取的局部变量、函数参数，但默认设置太宽松，容易漏：
- 进
Settings → Editor → Inspections → PHP → Unused symbols，必须勾选：Unused local variable、Unused parameter、Report variables used only for writing（否则像$tmp = json_encode($data);这种写完就丢的变量不会被标） - 取消勾选
Report unused array keys，除非你真在检查字面量数组里的硬编码 key -
foreach ($items as $item)里$item被标灰？先确认Settings → Languages & Frameworks → PHP → Language Level是否匹配项目真实版本（如 PHP 8.2），低版本无法解析短闭包或解构赋值，导致分析断链 - 右键项目根目录 →
Inspect Code…→ 范围选Whole project→ 导出 CSV 后人工核对：是否在tests/下？是否被__get()或魔术方法间接访问？是否出现在 YAML/JSON 配置的类名字符串里？
删冗余的 use 语句：开 Save 时自动优化，别依赖手动
保存时自动清理才是稳定方案，Ctrl+Alt+O 手动触发只适合临时补救：
- 必须开启
Settings → Editor → General → Auto Import → Optimize imports on save，该选项仅作用于当前项目，新建项目要重配 - 如果保存后
use没被删，先看右下角语言标识是不是PHP（不是Text），否则 IDE 不加载 PHP 相关行为 - 以下情况 PhpStorm 会跳过清理：
new $class动态调用对应的use；/** @var User $user */中的User；文件存在语法错误（括号不匹配、分号缺失）；PHP Language Level设置低于项目实际版本 - 想保留某个
use？在它正上方加一行注释：// @noinspection PhpUnusedAliasInspection，只对紧邻的下一行生效
删空行和空格：正则只是救急，长期靠 Save 时规则
批量删空行看似简单，但错用正则或忽略环境干扰，会导致 Git diff 飘白线、CI 报 warning：
立即学习“PHP免费学习笔记（深入）”；
- 别用
^\n—— 它只匹配真正无字符的换行，只要某行含 1 个空格或制表符就失效；稳妥写法是^\s*(?=\r?$)，能匹配“视觉上为空”的行（含空白字符但紧随换行符） - 执行前必须关掉
Settings → Editor → Code Style → Enable EditorConfig support，否则.editorconfig中的trim_trailing_whitespace = true或insert_final_newline = true会在你保存时悄悄加回空行 - 更可持续的做法是：开启
Strip trailing spaces on Save，并在Code Style → PHP → Blank lines中设Keep maximum blank lines = 1，让每次 Ctrl+S 自动压平 - 别直接对整个项目 Replace All —— 先试一个 PHP 文件，确认效果；函数之间、类方法之间的空行有语义分隔作用，不该无差别清除
真正麻烦的不是怎么删，而是“删什么”没有统一标准：一段被注释掉的代码，可能是待启用的功能，也可能是已废弃的逻辑；一个未被直接调用的私有方法，可能被反射或魔术方法访问。所有自动化手段都只覆盖显式引用，动态场景（call_user_func、__call、配置驱动类名）必须人工交叉验证。
