RegReplace插件不生效主因是快捷键冲突或未启用，需检查Package Settings、Key Bindings及控制台报错；配置时注意JSON双反斜杠转义、scope精确匹配、默认仅替换可视区等核心约束。
RegReplace插件安装后不生效，ctrl+shift+h没反应怎么办
多数情况是快捷键被其他插件（比如 Vintage 或 SideBarEnhancements）劫持，或插件未真正启用。先确认 RegReplace 已在 Preferences → Package Settings 列表中出现；再打开 Preferences → Key Bindings – User，检查是否已有冲突绑定——尤其留意 "keys": ["ctrl+shift+h"] 是否被覆盖。
- 临时验证是否加载成功：按
ctrl+shift+p输入RegReplace: Show Commands，能弹出命令列表即说明插件已激活 - 若快捷键失效，可手动添加用户键绑定：
[{"keys": ["ctrl+shift+h"], "command": "reg_replace"}] - Windows 下
ctrl+shift+h有时被系统热键拦截（如某些输入法），可改用alt+r等更稳妥组合
写 reg_replace.sublime-settings 时，find 和 replace 的语法和转义规则
RegReplace 使用 Python 的 re 模块语法，但配置文件是 JSON，所以反斜杠必须双写（\），且不能用原始字符串。常见坑点：匹配换行、捕获组引用、特殊字符字面量。
-
find中想匹配实际的"\\n"（JSON 解析一层 →"\n"，Python re 再解析一层 →" "） - 捕获组在
replace中用\1、\2引用，不是$1（后者是 JavaScript 风格，不支持） - 要替换为字面量反斜杠，
replace得写成"\\\"（最终输出一个） - 如果正则含
/（如路径），推荐用re.escape()思路预处理，或直接用[/]匹配字面斜杠
批量替换多个文件时，scope 和 files 配置怎么避免误伤
scope 控制作用域（如只在 source.python 中生效），files 控制文件路径过滤。二者不设或设宽泛会导致全局误替换，尤其跨项目时。
-
scope值必须是 Sublime 的语法 scope 名，可用ctrl+shift+alt+p查看当前光标位置的 scope 链，选最具体的一段（如string.quoted.double.python而非笼统的source.python） -
files支持 glob 模式："*.py"、"src/**.js"，但不支持正则；路径区分大小写（Windows 除外） - 测试阶段务必加
"enabled": false开关，再用RegReplace: Toggle Enabled逐条开启验证 - 慎用
"files": ["*"]—— 它会匹配所有打开的标签页，包括临时预览文件（如 Git 差异窗），可能引发不可逆修改
执行 reg_replace 命令后无反馈，或只替换了部分匹配项
默认行为是“仅替换当前视图可见区域”，不是全文。这是最常被忽略的机制——尤其当文件很大、有折叠代码块、或启用了 scroll_past_end 时。
- 确保光标在目标文本范围内，或先全选（
ctrl+a）再触发命令；否则 RegReplace 默认只操作 viewport 内内容 - 检查
reg_replace.sublime-settings中是否设置了"only_in_selection": true（默认为false），该选项开启后强制限制范围 - 大文件建议分批处理：用
Find → Find in Files...先定位所有匹配，再对每个结果文件单独运行 RegReplace - 若正则本身含
^或$，注意它们锚定的是“行首/行尾”，不是整个文件头尾；需加(?m)标志启用多行模式
RegReplace 的核心约束在于：它本质是“基于当前编辑器状态的增强查找替换”，不是独立的 CLI 工具。所有配置都依赖 Sublime 的语法识别、作用域计算和视图状态，一旦 scope 错、路径错、或视图未聚焦，就容易静默失败。调试时优先查 Ctrl+` 控制台有没有 RegReplace 相关报错，比反复试配置更省时间。
