应使用流式处理+二进制模式+原子替换：读取用fopen('rb')/fgets()，写入用file_put_contents(..., FILE_BINARY|LOCK_EX)，大文件需临时文件+rename()，HTML/XML/INI等须用专用解析器，避免str_replace误伤。
直接用 file_get_contents + str_replace 或 preg_replace 替换后写回，大概率会破坏原始换行符、BOM、缩进和空格——这不是你代码写错了，而是 PHP 底层文件 I/O 模式默认做了隐式转换。
为什么换行符总被悄悄改掉
Windows 用 \r\n，macOS/Linux 用 \n，但 file_put_contents 在未指定标志时，会按当前系统规则重写所有换行符。比如你在 Linux 上处理一个 Windows 生成的配置文件，\r\n 就会被统一转成 \n，导致某些老旧工具（如某些批处理脚本或嵌入式设备解析器）读取失败。
- 读取时：用
fopen($path, 'rb')+fgets()才能保留每行末尾原始换行符；file($path, FILE_IGNORE_NEW_LINES)会丢掉它们 - 写入时：必须显式传
FILE_BINARY标志，禁用自动换行转换：file_put_contents($path, $content, FILE_BINARY | LOCK_EX) - 若需跨平台归一化，先用
str_replace(['\r\n', '\r'], "\n", $content)统一为 LF，再按目标平台补回：str_replace("\n", PHP_OS_FAMILY === 'Windows' ? "\r\n" : "\n", $content)
正则替换吃掉缩进和空格怎么办
用 preg_replace('/old/', 'new', $text) 这种写法，匹配到行首的 old 时，前面的制表符或空格不会被带入捕获，替换后整行就左移了。
- 把空白纳入捕获组：
preg_replace('/^(\s*)old(\s*)$/m', '$1new$2', $text)，m修饰符让^/$匹配每行起止 - 避免用
.匹配任意字符——它不匹配换行符，跨行结构（如多行注释、HTML 标签块）会断裂；改用[\s\S]或(?s). - 替换前检查长度变化：
mb_strlen($old, 'UTF-8') !== mb_strlen($new, 'UTF-8')，字节差会影响后续缩进对齐，尤其混有中文时更隐蔽
大文件替换不爆内存的关键操作
超过 50MB 的日志或导出文件，file_get_contents 会吃光内存，且无法保证原子性。必须流式处理，但不能简单边读边写——那样会破坏文件权限、BOM 和最后一行结尾。
立即学习“PHP免费学习笔记（深入）”；
- 打开原文件只读：
$in = fopen($path, 'rb')；新建临时文件写入：$out = fopen($temp_path, 'wb') - 逐行读取：
fgets($in)，检测是否含目标模式，是则处理，否则原样fwrite($out, $line) - 处理完关闭句柄，用
rename($temp_path, $path)原子替换——这是唯一能防止写到一半崩溃丢失数据的方式 - 写入前检查 BOM：
fread($in, 3) === "\xEF\xBB\xBF"，若存在，手动在$out开头写入相同 BOM
HTML/XML/INI 文件别硬替
str_replace('title', 'heading', $html) 会把 <title></title>、subtitle、entitle 全部误伤，纯文本替换根本不识别语法边界。
- HTML/XML：用
DOMDocument解析，只替换textContent节点：$dom->loadHTML($html, LIBXML_HTML_NOIMPLIED | LIBXML_HTML_NODEFDTD) - INI 文件：别碰正则，用
parse_ini_file($path, true, INI_SCANNER_RAW)读，改数组后再用write_ini_file()（需自行实现）写回 - YAML/JSON：走对应解析器（如
symfony/yaml），否则格式错一个空格就整个文件失效
最易被忽略的点是：替换后文件权限、所有者、修改时间全丢了。用 rename() 替换能保留权限，但如果你用 file_put_contents() 直接覆盖，就得手动 chmod() 和 chown() ——而多数人根本没意识到这点。
