PhpStorm 的 Extract Constant 功能旨在提升代码可读性与可维护性，而非优化性能；仅当字面量多处重复、含义明确、值可能变化且无副作用时才应提取，并需手动检查命名、可见性、引用方式及类型注解。
直接说结论：PhpStorm 的 Extract Constant 不是用来“优化性能”的，它是用来提升可读性与可维护性的——把魔法字符串、数字字面量替换成有语义的常量名。误以为它能提速，反而容易在不该提的地方硬提，导致代码更难懂。
什么时候该用 Extract Constant
只在以下场景下提取才有意义：
- 同一字符串或数字在多个地方重复出现，且含义明确（比如
'user_status'、404、3600） - 当前值未来可能变化，且需要全局统一（如 API 超时秒数、默认分页大小）
- 原表达式不含副作用（不能是
time()、rand()、$obj->getId()这类每次调用结果不同的东西） - 你正在写的是类内逻辑，且希望常量属于该类作用域（此时会生成
self::XXX引用）
Extract Constant 按键失败或菜单灰掉的常见原因
不是 PhpStorm 坏了，而是你选的内容不满足基本前提：
- 光标没落在可提取的字面量上——比如你选中了整个
if (isset($params['status']))，但 PhpStorm 只允许对'status'这个字符串本身操作 - 选中内容含空格、换行或括号（如
'status' . '_key'是表达式，不是纯字面量，不能提） - 你在函数外、全局作用域里试图提取一个
const，但没勾选define()方式，而当前 PHP 版本不支持文件顶层const（PHP < 7.0） - 目标位置已有同名常量（尤其在命名空间或 trait 中），PhpStorm 会静默禁用入口
提取后必须手动检查的三件事
PhpStorm 生成常量很快，但后续维护隐患往往藏在细节里：
立即学习“PHP免费学习笔记（深入）”；
- 生成的常量名是否符合语义？比如把
'param_query'提成PARAM_QUERY合理，但若自动生成了STRING_123就得立刻重命名 - 可见性是否正确？类内提取默认是
public，但如果你只在当前类用，应手动改成private const（PHP 7.1+ 支持） - 引用方式是否一致？类内用
self::XXX，类外用ClassName::XXX或define()后的全局名，混用会导致 IDE 类型推导失效或运行时错误
最常被忽略的一点：提取常量后，原代码里的 isset($params['param_query']) 变成 isset($params[self::PARAM_QUERY])，看起来干净了，但如果 $params 是动态数组、没有类型注解，IDE 就再也不知道这个 key 是否存在——你得补上 /** @var array{param_query?: string} $params */ 才算真正闭环。
