str_replace适合简单固定字符串替换，速度快但无法处理动态模式；preg_replace支持正则匹配但易出错，需注意定界符、贪婪匹配、转义及UTF-8修饰符；无论哪种都须备份文件、校验编码与换行符处理。
str_replace直接替换文件内容最简单但有局限
如果只是把文件里某段固定字符串替换成另一段，str_replace够用，且比正则快。但它不能处理“类似但不完全相同”的模式，比如替换所有 id="xxx" 中的 xxx，或者只换第 2 次出现的 class="btn"。
实操建议：
- 先用
file_get_contents()读取整个文件（注意大文件会吃内存） - 替换后用
file_put_contents()写回，别忘了检查返回值是否为false - 若原文含双引号、反斜杠等特殊字符，确保传入的旧字符串和新字符串字面量一致，避免被 PHP 解析干扰（比如写成
" "而不是"\n"） - 批量处理多个文件时，
str_replace比preg_replace快 3–5 倍，优先选它
preg_replace必须写对模式才能安全替换
一旦要按规则匹配（比如替换所有 href=".*?" 或去掉注释 <!--.*?-->），就得用 preg_replace。但写错模式轻则没效果，重则删掉整段内容。
常见错误现象：
- 模式没加定界符（如漏写
/），报错PREG_NO_DELIMITER - 用了贪婪匹配
.*导致跨标签吞内容，应改用.*?或更精确的字符类（如[^"]*） - 没转义模式里的特殊字符，比如想匹配
$key却写成$key，实际要写成$key - UTF-8 文件中用了默认单字节模式，中文或 emoji 匹配失败，得加
u修饰符（/pattern/u）
替换前必须备份原文件，尤其用 preg_replace 时
preg_replace 的模式一旦写崩，可能把 HTML 标签结构全搞乱，甚至清空部分内容。而 str_replace 虽然“安全”，但替换错位置（比如把注释里的关键词也换了）一样不可逆。
实操建议：
- 用
copy($file, $file . '.bak')在操作前生成备份，文件名带时间戳更稳妥（$file . '.' . date('Ymd_His') . '.bak'） - 不要依赖 IDE 自动备份——它不感知你脚本里写的
file_put_contents - 如果处理的是生产环境配置文件（如
wp-config.php），建议先在副本上跑通再上线 - 替换后用
diff命令或简单strcmp()对比前后内容长度/哈希，确认改动符合预期
大文件别一次性加载，用流式逐行处理
当文件超过几 MB，file_get_contents() 容易触发内存限制，尤其在共享主机上。这时硬套 str_replace 或 preg_replace 都会失败。
可行方案：
- 用
fopen()+fgets()逐行读，对每行做str_replace（适合换行符分隔明确的场景） - 若需跨行匹配（比如 HTML 注释横跨多行），
preg_replace就不适用了，得改用 DOM 解析或临时缓冲若干行 - 用
stream_filter_append()注册自定义 filter，在读取流时实时替换，内存占用恒定但开发成本高 - 命令行下更简单：直接用
sed -i 's/old/new/g' file.php，避开 PHP 内存问题
真正麻烦的从来不是函数选哪个，而是你没意识到文件编码是 GBK、替换后变乱码，或者正则里忘了 s 修饰符导致 . 不匹配换行——这些细节不会报错，只会悄悄毁掉数据。
