Ubuntu下使用 PhpStorm 进行代码重构
一 准备与快捷键总览
- 打开项目：启动 PhpStorm → File → Open/Import Project 选择你的 PHP 项目；建议先提交或备份当前变更。
- 打开重构菜单：在编辑器中对符号或选中代码右键 Refactor，或使用快捷键 Ctrl + Alt + Shift + T（Linux/Windows）。
- 常用重构快捷键（Linux/Ubuntu）：
- 重命名：Shift + F6
- 提取方法：Ctrl + Alt + M
- 提取变量：Ctrl + Alt + V
- 内联：Ctrl + Alt + N
- 移动成员：F6
- 修改函数签名：Ctrl + F6
以上菜单与快捷键在 Ubuntu 与 Linux 环境下一致可用。
二 常用重构操作与步骤
- 重命名（变量/方法/类/文件）：将光标置于目标符号或选中它 → 按 Shift + F6 → 输入新名称 → 回车；可预览变更并一键替换所有引用。
- 提取方法：选中代码片段 → Ctrl + Alt + M → 设置方法名、参数与返回值 → 预览并确认；适合拆分长函数、提升复用。
- 提取变量/常量/属性：选中表达式 → Ctrl + Alt + V（变量）、Ctrl + Alt + C（常量）、Ctrl + Alt + F（属性）→ 命名并完成替换。
- 内联：将变量/方法的使用处替换为定义处 → Ctrl + Alt + N → 选择内联范围（当前位置或全部）。
- 移动成员/方法：将光标置于方法或属性 → F6 → 选择目标类/文件 → 确认；自动修正调用与引用。
- 修改函数签名：将光标置于函数名 → Ctrl + F6 → 增删/重排参数、修改返回值与可见性 → 预览并应用。
- 安全删除：在类/方法/属性/文件上右键 Refactor → Safe Delete → 若存在引用会提示，避免误删。
- 提取接口：在类上右键 Refactor → Extract Interface → 勾选要提取的方法 → 生成接口并替换实现。
以上操作覆盖日常 PHP 开发中最常用的重构场景。
三 重构前中后的最佳实践
- 开始前：确保项目已保存、无编译/语法错误；使用 Git 提交或创建还原点，便于回滚。
- 重构中：优先使用带有预览的重构（如重命名、提取方法），逐项检查变更列表，确认影响范围。
- 完成后：运行单元测试/功能测试，查看 PHPStan/Psalm 等静态分析是否通过；必要时逐步提交，便于定位问题。
四 常见问题与排查
- 快捷键无效：检查是否处于输入法冲突或自定义快捷键覆盖；可在 Settings → Keymap 搜索 Rename/Extract Method 恢复默认或自定义。
- 未识别符号：确认项目已正确配置 PHP 解释器（Settings → Languages & Frameworks → PHP），并正确设置 Include Path/Composer 依赖，以便索引完整。
- 重构未生效或引用未更新：执行 File → Invalidate Caches / Restart，重建索引后重试。
- 大型重构风险高：拆分步骤、频繁小步提交；对公共 API 变更配合接口/适配层，降低耦合。
以上排障思路与项目配置要点可显著提升重构稳定性。
