VSCode不支持一次替换多个不同关键词，因其全局替换引擎仅接受单模式匹配，无法实现“匹配A则换X、匹配B则换Y”的分支逻辑；虽可用正则捕获组在共上下文场景（如console.后）差异化替换，但无结构关联的词仍需分批处理，且须注意顺序、全字匹配及import等特殊行的单独处理。
VSCode 本身不支持一次操作替换多个不同关键词（比如同时把 foo → bar、baz → qux），必须分批执行；但可以通过正则捕获组 + 条件替换、或配合插件实现“伪多关键词”批量处理。
为什么不能直接一次替多个不同词
VSCode 的全局替换是单模式匹配引擎，每次搜索只接受一个正则或字符串模式，Replace All 操作只基于当前输入的查找内容和替换内容。你无法在同一个替换动作里定义「如果匹配 A 就换为 X，匹配 B 就换为 Y」——它没有分支逻辑。
- 输
foo|baz只能统一替成同一个新串（如xxx），无法差异化替换 - 试图用
$1引用未定义捕获组会留空或报错 - 插件如
multi-command或find-and-transform可模拟，但本质仍是串行执行多次替换
用正则捕获组做“条件式单次替换”
当多个关键词有共同上下文（比如都出现在 console. 后面），可用 | 分支 + 捕获组 + $1/$2 实现差异化替换。例如统一改日志方法名：
查找：<code>console\.(log|warn|error)\(\s*([^)]+)\s*\)</code> 替换：<code>logger.$1($2)</code>
这个操作把 console.log('x') → logger.log('x')，console.warn('y') → logger.warn('y')，一次完成。关键点：
- 必须用括号包裹每个分支，确保能被
$1、$2等引用 - 所有分支要保持相同数量的捕获组，否则
$2在某些匹配中会为空 - 不适用于无结构共性的词（如
getUser和postOrder完全无关）
分批替换时怎么避免互相干扰
比如要把 oldFunc → newFunc，同时把 oldHelper → newHelper，两个替换若顺序不对，可能让第二次替换误触第一次改完的内容：
- 先替换更长、更唯一的词（如
oldHelper），再换短的（oldFunc），减少重叠风险 - 每次替换后，用
Ctrl+Shift+F搜索新名称，确认没残留旧词，也确认没意外生成新旧混搭（如newHelperFunc） - 对 import 行单独处理：搜
import.*oldFunc和import.*oldHelper，分别替换，避免正则跨行误匹配 - 开启
Match Whole Word（AaBb 按钮）或用\boldFunc\b，防止oldFuncAsync被误伤
真正需要多关键词映射时，别硬扛
如果项目里真有几十组函数/变量名映射（如迁移 SDK 版本），纯 VSCode 手动操作极易出错。此时该换工具：
- 用
find-and-transform插件，写 JSON 规则：{"find":"oldFunc","replace":"newFunc"},{"find":"oldHelper","replace":"newHelper"}，它会自动按序执行 - 写一行 shell 脚本（Linux/macOS）或 PowerShell（Windows），调用
sed或perl -pi批量处理文件，比 GUI 更可控 - TS 项目优先走
tsc --build+ 类型检查 +ts-morph脚本做语义级重命名，安全边界远高于文本替换
最常被忽略的是：替换完 import 路径和导出名不同步。比如改了 utils.ts 里的函数名，但 index.ts 里 export { oldFunc } 还没动——这种漏网之鱼不会报错，但运行时就炸。
