3.6.2 跨文件代码批量修改

在实际项目里，经常需要把散落在几十甚至上百个文件中的某个变量名、函数名、路径或配置参数一次性改掉。手动逐个打开文件修改不仅低效，还容易出错。本节介绍几种常用、稳定且容易上手的跨文件批量修改方法。

一、命令行工具：适用于 Linux/macOS/WSL

1. `find` + `sed`：基本功

# 将 src 目录下所有 .js 文件中的 oldApi 替换成 newApi（直接修改文件）
find src/ -name '*.js' -exec sed -i '' 's/oldApi/newApi/g' {} +

-i '' 表示就地编辑（macOS 中备份后缀为空串；Linux 下直接用 -i 不带参数）
建议先用 -exec sed 's/oldApi/newApi/g' {} + 不加 -i 预览改动
如需处理更多模式，可写成脚本，但单行命令适用于简单纯文本替换。

2. `grep` + `sed`：只改含特定文本的文件

先用 grep -rl 找出真正包含目标字符串的文件列表，再交由 sed 修改，避免对所有文件执行 sed：

grep -rl 'oldApi' src/ | xargs sed -i 's/oldApi/newApi/g'

这样可以明显加快速度，尤其在 .git、node_modules 等大目录已被 .gitignore 排除后。

3. 使用 `ripgrep`（`rg`）更高效

rg -l 'oldApi' src/ | xargs sed -i 's/oldApi/newApi/g'

rg 默认跳过 .gitignore 中的忽略项，搜索极快。

二、IDE/编辑器的全局替换

现代编辑器的“在文件中查找替换”功能已经非常成熟，多数情况下更直观安全。

VS Code：Ctrl+Shift+H（或 Cmd+Shift+H）打开全局搜索替换面板，输入正则或普通文本，支持预览、逐文件确认，还可在替换前用 Alt+Enter 全选所有匹配。
JetBrains 系列（IntelliJ / PyCharm / WebStorm 等）：Ctrl+Shift+R（Cmd+Shift+R）可进行结构性替换，并支持基于语法感知的重构（例如重命名符号），这比纯文本替换更精准。
Sublime Text：Find > Find in Files...，勾选正则选项。

优势：支持正则、大小写匹配、排除特定路径，且有可视化的确认流程，特别适合复杂替换。

三、编写脚本：可复用、带逻辑的修改

当替换不是简单的文本映射，比如需要根据上下文动态生成内容，或跨多个项目结构修改时，用脚本更合适。

Python 示例（使用 fileinput 模块）：

import fileinput
import re

for line in fileinput.input(files=('file1.py', 'file2.py'), inplace=True):
    # 只替换以 '# TODO' 开头的行中的 'oldFunc' 为 'newFunc'
    if line.startswith('# TODO'):
        line = line.replace('oldFunc', 'newFunc')
    print(line, end='')

配合 glob 遍历文件：

import glob, fileinput

with fileinput.input(files=glob.glob('src/**/*.py', recursive=True), inplace=True) as f:
    for line in f:
        line = re.sub(r'\boldApi\b', 'newApi', line)
        print(line, end='')

inplace=True 将修改写回原文件，内部通过临时文件并重命名实现，较安全。

四、实用原则与风险控制

版本控制先行：执行批量修改前，确保所有改动文件已提交或处于干净状态，方便用 git diff 检查变化，出问题时 git checkout . 回退。
先测后改：无论用 sed 还是脚本，先不加 -i 或 inplace，输出到终端或用 diff 比较。
精确匹配：用正则词边界 \b 或结构化工具（如 IDE 的重命名）避免把 oldApiName 中的 oldApi 也误改。
排除无关目录：命令行中务必过滤 node_modules、dist、.git 等；IDE 中设置排除规则。
备份：若没有版本控制，可先用 sed -i.bak 生成 .bak 备份文件。

掌握上述方法，就能在几分钟内完成横跨整个项目的代码批量调整，既快又稳。