替换前必须确认匹配范围是否准确，Sublime正则替换默认全局生效，需先用Find All预览高亮结果，避免误改注释、字符串字面量及拼接逻辑中的相似片段，并通过捕获组保留原引号类型与空格格式。
替换前必须确认匹配范围是否准确
Sublime 的正则替换默认是全局的，Ctrl+H 打开后一按 Replace All 就全文件生效，没备份就很难回退。务必先用 Find All（或 Enter 键）看高亮结果是否全是目标——尤其注意别误中注释、字符串字面量里的相似片段，比如想换 "api_v1" 却把 // api_v1_legacy 或 'https://example.com/api_v1' 也替了。
建议操作顺序：
– 开启 .* 按钮（启用正则）
– 输入模式如 "api_v1"，观察匹配项
– 若需排除注释，加负向先行断言：(?（注意空格和引号位置）<br>– 若只换变量赋值右侧的硬编码，用 <code>=\s*"(api_v1)"
处理带转义或动态拼接的硬编码更难识别
真实代码里硬编码常藏在拼接逻辑中，比如 url = base + "/api_v1" + endpoint 或 path = "api_" + version + "/users"。这类无法靠简单字符串匹配捕获，得靠上下文模式。
常见可捕获结构示例：
– \+\s*["']api_v1["'] 匹配 +"/api_v1"
– ["']api_v1["']\s*\+ 匹配 "api_v1" +
– ["']api_v1/[^"']*["'] 匹配带路径的完整字符串如 "api_v1/users"
注意：JavaScript 中模板字符串 `api_v1/${id}` 需单独处理，用 `api_v1/[^`]*`
替换时保留原始引号类型和空格格式
硬编码可能用单引号、双引号甚至反引号，直接写死 "new_api" 会破坏原有风格。Sublime 支持捕获组引用，用 $1new_api$2 可复用原引号。
推荐写法：
– 查找：(["`'])api_v1(["`'])
– 替换：$1new_api$2
– 若含路径且要保留斜杠前后空格：(["`'])\s*api_v1\s*(["`']) → $1 new_api $2
注意：Sublime 不支持条件替换（如“单引号就用单，双引号就用双”），所以统一用捕获组最稳
跨文件批量替换要注意项目结构和作用域
用 Find in Folder...（Ctrl+Shift+F）批量扫整个目录时，容易误改 node_modules、build 输出或配置文件。务必在查找面板顶部的 Where 栏限定路径，例如：
– src/**/*.js
– !node_modules, !dist, !build
– 或更精准：src/api/**.ts
另外，不同语言对字符串解析规则不同：Python 的三重引号、JSON 文件的严格双引号、HTML 中的属性值（data-api="api_v1"）都需单独测试正则。一个通用但保守的模式是：(["'`])api_v1(?!\w)\1，靠首尾引号一致性和词边界避免连字符误匹配
真正麻烦的不是怎么写正则，而是得反复验证：改完一处，立刻跑单元测试或手动点几个接口，看有没有漏掉拼接分支或环境变量兜底逻辑。硬编码往往藏在最不像硬编码的地方。
