PhpStorm 的 Macro 录制必须从光标位置开始，不响应鼠标选区，回放时严格按录制时的光标坐标、文件类型和编辑器状态执行，环境不一致易导致失败。
Macro 录制必须从光标位置开始，不能靠选中文本触发
PhpStorm 的 Macro 不是“选中→录制→保存”流程，它根本不管你的鼠标选区。录制时所有按键、快捷键、输入内容都会被原样记下，但起点永远是当前光标所在位置——哪怕你拖选了十行，光标停在第 3 行开头，回放时就从第 3 行开始执行。
常见错误现象：Ctrl+Shift+J 合并行后光标跳到行尾，接着录 Home → Shift+End → Delete，结果回放时删掉整行而非预期内容；或在 PHP 文件里录了 /* */ 注释包裹，到 JS 文件里回放却触发 // 单行注释，甚至因语法不匹配导致编辑器卡住。
- 录制前把光标放在你要操作的起始位置（比如要包裹代码块，光标应放在第一行开头）
- 避免用鼠标拖选，全程用键盘导航：
Ctrl+Right跳词、Ctrl+Shift+Right扩展选区、Ctrl+Alt+Left/Right切换编辑器标签 - 清空剪贴板（
Ctrl+X然后立即Esc），否则回放时可能意外粘贴旧内容 - 别切出 PhpStorm 窗口——Alt+Tab 切到浏览器也会被录进去，回放时直接跳转走
保存宏后必须手动绑定快捷键，否则无法调用
保存宏只是存进配置文件，不会自动出现在菜单或工具栏。没绑快捷键的宏等于没做——你得自己去 Settings → Keymap → Macros 下找到它，右键选 Add Keyboard Shortcut。
Mac 用户尤其容易踩坑：Ctrl 和 Cmd 键映射错位。如果在 macOS 设置里选了 Windows/Linux 键位方案，按 Cmd+Shift+1 实际触发的是 Ctrl+Shift+1，宏根本不会响应。
立即学习“PHP免费学习笔记（深入）”；
- 推荐组合：Windows/Linux 用
Ctrl+Shift+[0-9]，macOS 用Cmd+Shift+[0-9]，避开Ctrl+Alt+O（优化导入）、Ctrl+Alt+L（格式化）等高频默认键 - 绑定后测试一次：随便开个新文件，按快捷键看是否执行——没反应先检查是否被 Vim 插件劫持（Vim 模式下很多组合键失效）
- 名字别用空格或中文，像
WrapWithDiv或LogDebugWrap这种纯英文驼峰名，方便后续在 Keymap 里搜索
宏回放失败的三大硬伤：光标偏移、文件类型不一致、编辑器状态变化
Macro 是纯机械重放，不是智能脚本。它不理解代码含义，只认按键顺序和光标坐标。所以哪怕只差一行，或文件后缀从 .php 换成 .js，都可能让整个流程卡死。
典型症状：Ctrl+Down 在有折叠区域的文件里跳过整段代码，导致后续 Shift+End 选错范围；Power Save Mode 开着时补全延迟，Tab 补全没出来就按了 Enter，结果插入的是原始缩写而非展开后的内容。
- 回放前确认：光标位置是否与录制时一致（可用
Ctrl+G输入行号快速跳转） - 确保当前文件类型匹配（PHP 宏别在 Blade 模板里用，JS 宏别往 Vue SFC 的
<script>块里扔） - 关闭 Power Save Mode（
File → Power Save Mode），禁用临时插件（如某些 AI 补全插件会拦截快捷键） - 复杂操作建议拆成多个小宏：一个负责选中，一个负责包裹，一个负责格式化——比单个大宏更稳定
Macro 和 Live Template 别混用：一个录动作，一个插代码
很多人想用 Macro 实现 “输入 logd → 展开为 Log::debug('$SELECTION$');”，这完全走错路。Live Template 才干这事，Macro 只能录下你手动敲 logdTab 的全过程，效率低还易错。
真正适合 Macro 的场景非常具体：比如每天都要对某段 SQL 字符串执行 “选中 → Ctrl+Shift+J → Ctrl+Alt+L → Ctrl+S”，这一串固定操作链，Live Template 做不了，就得靠 Macro。
- Live Template：适合高频代码结构，支持变量占位（
$SELECTION$）、上下文过滤（只在 PHP 文件生效） - Macro：适合编辑流程自动化，比如 “打开侧边栏 → 切到 Terminal → 输入 git status → 回车 → 切回编辑器”
- File Template：新建文件时用，和编辑时的操作完全无关
宏的本质是按键录像，不是逻辑判断。它最脆弱的地方不在功能多寡，而在环境一致性——光标在哪、文件类型是什么、编辑器开了什么模式，这些细节漏掉一个，回放就可能崩。实际用的时候，宁可多录几次小宏，也别贪图省事塞一堆操作进一个宏里。
