PhpStorm的Extract Constant功能仅对当前光标处纯字面量生效，非批量工具；它依赖静态分析识别无副作用、可确定作用域的单个值（如404、'user_status'），不扫描项目，选中含括号、空格、运算或拼接的表达式时菜单即灰掉。
PhpStorm 的 Extract Constant 功能不是用来“替换所有相同值”的批量工具，它只对当前光标所在的一个**纯字面量**生效；强行想靠它一键处理散落在各处的 404、'user_status' 或 3600，大概率失败或生成错误引用。
为什么 Extract Constant 不会自动找所有重复值
这个操作本质是“语义化单点”，不是“全局搜索替换”：它依赖 IDE 对当前表达式的静态分析，只接受无副作用、可确定作用域的字面量。比如你选中 404，它能提；但选中 http_response_code(404) 就不行——括号让整个结构变成调用表达式，不再是纯字面量。
- 它不扫描项目/目录，只处理你当前选中的那一小段文本
- 即使同一数字在 5 个文件里出现，也得手动进每个地方单独触发
Ctrl+Alt+C - 若该值出现在字符串拼接中（如
'status_' . $code），或带运算（如60 * 60），IDE 直接禁用菜单项
Ctrl+Alt+C 失败的常见现场
菜单灰掉、快捷键没反应，通常不是配置问题，而是光标没落在合法目标上：
- 光标在引号外、空格后、或紧贴括号（如
'active'的末尾引号外）→ 不识别为字符串字面量 - 选中了带空格的文本，比如
'active'（末尾多一个空格）→ 被判定为非法字面量 - 你在全局作用域（.php 文件顶层）提取常量，但 PHP 版本 define() 方式 → 提取失败
- 当前文件未被识别为 PHP（右下角显示 Plain Text）→ Refactor 菜单整体不可用
真要批量处理魔法数字？用正则 + Replace in Path
当你要把全项目中所有裸露的 3600 替换为 self::CACHE_TTL，Extract Constant 不适用，得切到正则模式：
立即学习“PHP免费学习笔记（深入）”；
- 按
Ctrl+Shift+R打开Replace in Path - 点击右上角
.*按钮启用正则 - Find:
\b3600\b（\b确保匹配独立数字，不误伤36001） - Replace:
self::CACHE_TTL，但注意：这不会自动加const CACHE_TTL = 3600;，需手动补全定义 - 务必先点
Find预览所有命中位置，确认无误再Replace All
更安全的做法是分两步：先用正则把所有 3600 替换成一个临时占位符（如 %%%CACHE_TTL%%%），再在类顶部手写 const，最后全局替回真实引用——避免漏定义导致运行时报错。
提取后必须人工检查的三个地方
就算 Ctrl+Alt+C 成功弹出对话框并完成，以下三点不核对，常量就埋了坑：
- 命名是否准确？
STATUS_ACTIVE比NUM_1强，但DEFAULT_TIMEOUT_SEC比TIMOUT更不易歧义 - 可见性是否合理？在类内提取默认是
private const，若子类也要用，得手动改成protected或public - 类型注解是否同步？PHPStorm 不会自动给
const加@var int，但如果你的代码启用了严格类型检查，缺失注解会导致后续is_int(self::CACHE_TTL)报告类型不明确
最易忽略的是跨文件引用：提取发生在 User.php，但 AuthController.php 里直接写了 User::STATUS_ACTIVE —— 如果你提取时没勾选“Use fully qualified name”，它可能生成 self::STATUS_ACTIVE，导致其他文件调用失败。
