因为[^)]*不匹配换行符，且^、$、.默认均为单行模式，导致跨行console.log()无法被完整捕获；需启用(?s)模式并改用(.*)?等跨行结构才能可靠匹配。

为什么^s*console.log([^)]*);s*$匹配不了跨行的console.log？

因为 Sublime 默认的 . 不匹配换行符，^ 和 $ 也只锚定单行首尾。你写的表达式里 [^)]* 遇到换行就停了，后面的内容根本进不来匹配范围。

常见错误现象：在多行函数调用（如 console.log( "hello" );）中零匹配，但单独一行时能搜到——这几乎 100% 是跨行问题，不是正则逻辑错。

• 别用 [sS]* 强撑：虽然能工作，但性能差、易卡顿，尤其在大文件里
• 优先考虑结构重构：把跨行调用先格式化成单行（比如用 Prettier），再用稳定正则处理
• 真要跨行匹配，必须显式启用 dotall 模式：(?s) 放在表达式最前面，例如 (?s)console.log([^)]*)
• (?s) 只影响它后面的 .，不影响 [^)] 这类字符类，所以括号内仍可能被截断；若参数本身含换行，得改用 (?s)console.log((.*?)) 并人工确认边界

如何安全提取多行注释块里的 URL？

比如从 /* * API: https://api.example.com/v1 * Auth: bearer xyz */ 中只取 URL 那行。不能靠 .* 直接扫，容易吞过头或漏掉换行。

正确做法是用 (?s) + 明确起止标记，同时避免贪婪越界：

• 查找：(?s)/*s*(?:*[^*]**)*s*API:s*(https?://[^s*]+)
• 解释：(?s) 启用点号跨行，*[^*]** 粗略跳过中间注释行，https?://[^s*]+ 锁定 URL 字符范围，防止吃到下一个 * 或换行
• 不推荐 (?s)/*(.*?)API:s*(https?.*?)*/：中间的 .*? 在跨行时可能匹配到其他 /* 块开头，造成错位
• 执行前务必勾选 In Selection，先框选目标注释块再替换，避免全局误卷

替换时 $1 为啥原样输出，而不是捕获内容？

这是新手最高频的“以为正则生效了”的假象。根本原因：替换面板的正则开关是独立的，没点亮右下角的 .* 图标，$1 就只是两个字符。

另一个隐藏坑：查找时用
引用捕获组，但替换字段里必须用 $1，写成
或 \1 都无效。

• 查找：fetch(([^)]+)) → 替换：api.fetch($1)（正确）
• 错误写法：api.fetch(
) 或 api.fetch(\1) → 输出字面量

• 如果要输出真实美元符号，写成 $$，例如 cost: $$100
• Ctrl+H 打开替换面板后，哪怕查找面板已开正则，也必须再点一次 .* —— 它们状态不共享

全局替换多行内容时，Where 路径过滤为什么比正则还关键？

因为 (?s) 会让正则“变宽”，一旦路径没锁死，它可能跨文件把 node_modules 里的 minified 代码、dist/ 下的打包产物甚至 Markdown 示例全卷进去，而你根本看不到中间过程。

真正出事的从来不是正则写错，而是 Where 栏填了 * 或留空。

• 安全写法：src/**/*.js, src/**/*.ts（只限源码目录）
• 排除黑名单：!node_modules, !dist, !build（前面加 !）
• 执行前必点 Find All，看右下角预览列表是否每条路径都在预期范围内
• 如果预览里出现 package-lock.json 或 README.md，立刻停手，改 Where 条件

最常被忽略的是：跨行正则天然更难预判匹配边界，这时候作用域控制不是辅助项，是安全底线。