宏录制前须将光标置于目标行首并确保UTF-8/ANSI编码，关闭干扰插件；录制时按Home→#→↓，保存后需在快捷键管理器绑定并重启Notepad++才生效。
宏录制前必须确认光标位置和文档状态
Notepad++ 的宏不是智能脚本，它只机械回放你录下的每一步操作。如果你录的是“按 Home → 输入 # → 按 ↓”，那执行时就会从当前光标所在行开始，逐行执行这三步——哪怕光标在第 50 行中间，它也会先跳到该行开头、加 #、再下移一行。所以每次运行前，务必手动把光标放到第一处目标行的行首（推荐用 Ctrl+Home 跳到文件开头，再用 ↓ 或 Ctrl+→ 微调）。
另外，确保文档编码是 UTF-8 或 ANSI，避免宏执行中因 BOM 或混合编码导致光标偏移或替换失败；如果开了 Python Script 或 NppExec 插件，建议临时关闭——它们会让 Ctrl+Shift+R 启动录制有 1–2 秒延迟，REC 状态栏没稳定显示就操作，前几步会漏录。
录制“行首添加 #”宏的关键操作顺序
不能直接开录就点查找替换，因为宏会把“打开查找框”“勾选正则”这些 UI 操作也录进去，后续执行容易卡在对话框里。正确顺序是：
• 点击菜单 宏 → 开始录制，等右下角状态栏出现稳定不闪烁的 REC
• 按 Home 回到当前行开头
• 按 # 键输入注释符
• 按 ↓ 移动到下一行（这一步决定宏是否可批量叠加）
• 点击菜单 宏 → 停止录制（注意：Ctrl+Shift+P 是播放宏，不是停止键）
• 点击 宏 → 保存当前录制宏，命名为类似 PyLineComment
保存后快捷键不生效？必须手动绑定并重启
“保存宏”只是把操作序列存进内存，不会自动映射快捷键，更不会持久化。常见错误是保存完就去按 Ctrl+Alt+1，结果没反应——因为：
• Ctrl+Shift+1～Ctrl+Shift+9 默认被其他功能占用，优先改用 Ctrl+Alt+M 或 F5～F12
• 必须进 设置 → 快捷键管理器 → 宏 标签页，找到刚命名的宏，点击“指定快捷键”
• 修改后必须重启 Notepad++，否则快捷键不加载（顺便检查 设置 → 首选项 → 备份 → 在启动时加载宏 是否已勾选）
执行宏时行数错位或漏处理？问题几乎都出在起始点和绝对操作上
比如你录的是“Home → # → ↓”，但实际想注释第 3～10 行，结果宏从第 1 行开始执行，第 11 行还多加了一个 #。这是因为宏没有“选区判断”，它只认你录时的光标起点和固定步数。解决办法只有两个：
• 手动把光标提前放到第 3 行行首，再触发宏
• 录制时改用键盘选区：录“Shift+↓ 选中 8 行 → Home → #”，这样宏就只作用于你选定的范围（但要注意：用鼠标拖选会被录成坐标操作，不同 DPI 下可能漂移，坚决不用）
还有一个隐藏坑：如果文档末尾有空行，↓ 会走到空行再加 #，建议执行前先用 编辑 → 行操作 → 删除尾部空行 清理一下
