Sublime默认按纯文本匹配，不识别语法上下文，故搜索会误改注释内容；需先用正则^\s*(?://|#).*\$清除行注释干扰，再处理块注释，最后结合路径限定与\b锚点执行安全替换。
为什么直接搜关键词会误改注释里的内容
因为 Sublime 默认不区分语法上下文，// getUser(id) 和 getUser(id) 在正则里都是普通字符串。你搜 getUser，它不会跳过注释行，结果把 // getUser() is deprecated 也替了——这不是 bug，是设计如此：Sublime 的查找替换本质是文本扫描，不是 AST 解析。
用 ^\s*(?://|#).*$ 先临时屏蔽行注释
这不是“排除”，而是“先清掉干扰项”。行注释必须锚定在行首或缩进后，否则会误吞 URL 或字符串。实际操作分两步：
- 打开
Ctrl+H（Windows/Linux）或Cmd+H（macOS） - 查找框填：
^\s*(?://|#).*$，勾选Regular Expression，关闭Match Case和Whole Word - 替换框留空，点
Replace All - 做完这步再执行你的主替换（比如
getUser→fetchUser），就不会碰注释了
注意：^\s* 中的 \s 包含制表符和空格，(?://|#) 是非捕获组，只匹配但不占 $1 位置；别写成 ^//.*$，否则 https:// 会被砍半。
块注释不能靠一次正则“排除”，得先删或先隔离
想边查边跳过 /* ... */？做不到。Sublime 没有“负向先行断言”支持，也没有语法感知能力。唯一可靠路径是预处理：
- 先用
/\*[\s\S]*?\*/删除所有块注释（务必勾选右下角.\n图标） - 再执行你要的全局替换
- 如果不能删注释，就换思路：把整个块注释替换成唯一标记，比如
__BLOCK_COMMENT__，替换完再换回去
别用 /\*.*?\*/——不勾 .\n 时它连单行块注释都可能漏；勾了却没加 ?，它会从第一个 /* 一路吃到文件末尾最后一个 */，中间代码全丢。
真正安全的全局替换流程：先范围、再过滤、最后人工抽检
你在 Ctrl+Shift+F 里输的 Where 路径，不是“排除注释”，而是“排除含注释风险的文件”。比如：
- 限定范围：
./src/**/*.ts, ./src/**/*.js（避开docs/或examples/这类注释密集区） - 排除构建产物：
-./dist -./build -./node_modules - 加
\b锚点防误替：\bgetUser\b不会匹配getUserById
最关键的一步常被跳过：点 Find All 后，至少扫三处高亮——开头的 import 行、中间的函数调用、结尾的配置对象。只要有一处是注释或字符串里的目标词，就得收手重写正则。不是所有场景都适合全自动，有些地方就是得手动点 Replace 确认。
