直接用file()读取再写回最稳妥：它将文件转为数组，避免行号错位和换行符不一致问题；需用FILE_IGNORE_NEW_LINES去换行符，索引从0开始，写回时implode("\n", $lines)并补末尾\n。
直接用 file() 读取再写回是最稳妥的做法
PHP 没有原生“替换第 N 行”的函数，file() 把文件按行转成数组后操作最直观，也避免了流式读写时行号错位、换行符不一致（\n vs \r\n）导致的偏移问题。
常见错误是试图用 fgets() + 计数器边读边写，结果新内容长度和原行不一致，把后续行全挤乱了——这不是替换，是破坏。
实操建议：
- 用
file($path, FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES)读取，FILE_IGNORE_NEW_LINES去掉每行末尾换行符，省得手动trim() - 修改目标行时，注意数组索引从
0开始，第 5 行对应$lines[4] - 写回前务必检查索引是否越界：
if (isset($lines[$line_number - 1]))，否则会报Undefined offset - 用
file_put_contents($path, implode("\n", $lines) . "\n")写入，末尾补一个\n保证最后一行有换行符（多数编辑器期望如此）
preg_replace() 适合按内容匹配替换，不是按行号
如果要替换“包含某个关键词的那行”，而不是“第几行”，preg_replace() 配合 file_get_contents() 更合适。但要注意：它处理的是整个字符串，不是数组，正则模式必须能准确锚定整行。
立即学习“PHP免费学习笔记（深入）”；
典型场景：把配置文件里 debug = false 替换成 debug = true，且只改这一行，不碰其他含 false 的地方。
实操建议：
- 用
^debug\s*=\s*false$模式，^和$锚定行首行尾，m修饰符让^$对每行生效 - 写法示例：
preg_replace('/^debug\s*=\s*false$/m', 'debug = true', $content) - 别用
/i（忽略大小写）除非真需要，否则可能误替DEBUG或Debug - 替换后直接
file_put_contents()写回，无需手动拼换行符——file_get_contents()保留原始换行符
大文件慎用 file()，内存会爆
几百 MB 的日志或数据文件，file() 会把全部内容载入内存，PHP 进程可能被系统 kill，或者触发 Allowed memory size exhausted 错误。
这时只能流式处理，但必须确保“替换行长度不变”，否则无法原地覆盖。实际中几乎不可行——所以真实方案是：
- 用
fopen()逐行读fgets()，同时写到临时文件；遇到目标行时写新内容，其余照抄 - 替换完用
rename()原子化替换原文件（Linux/macOS 下安全，Windows 下需先unlink()） - 务必在写临时文件前检查磁盘空间：
disk_free_space()，否则写到一半失败，原文件已删，数据就丢了 - 临时文件路径用
sys_get_temp_dir()+uniqid()生成，避免并发冲突
Windows 下换行符和文件锁容易出问题
在 Windows 上用 file_put_contents() 写文件时，如果文件正被记事本或某些编辑器打开，会报 Permission denied；而换行符混用（\r\n vs \n）会导致行号计算偏差。
实操建议：
- 读文件时加
FILE_TEXT标志（PHP 8.1+），自动统一换行符为\n；旧版本可用str_replace("\r\n", "\n", file_get_contents($path))预处理 - 写文件前先
clearstatcache(true, $path)，防止 Windows 缓存文件状态导致is_writable()判断失准 - 关键操作加
try...catch，失败时保留原文件备份（比如写之前copy($path, $path . '.bak')）
替换逻辑本身简单，真正复杂的是边界：空行怎么算、BOM 怎么处理、符号链接要不要跟随、权限是否可写……这些细节不提前踩一遍，上线后半夜收告警。
