本文详解如何使用 python 递归遍历指定目录及其所有子目录，安全、准确地批量替换所有 .php 文件中的特定字符串（如数据库名），并提供完整可运行代码与关键注意事项。
本文详解如何使用 python 递归遍历指定目录及其所有子目录，安全、准确地批量替换所有 `.php` 文件中的特定字符串（如数据库名），并提供完整可运行代码与关键注意事项。
在 Web 项目迁移（例如更换数据库名称）过程中，常需批量更新大量 PHP 源文件中硬编码的数据库标识符。手动编辑不仅低效易错，还极易遗漏深层子目录中的文件。Python 的 os.walk() 配合正则表达式是理想的自动化解决方案——但初学者常因忽略文件路径拼接而报错（如 FileNotFoundError: [errno 2] No such file or Directory），正如问题中所示：filename 仅返回文件名（如 “index.php”），而非完整路径。
正确做法是将 root（当前遍历到的目录绝对路径）与 filename 用 os.path.join() 安全拼接，生成目标文件的完整路径。以下是经过生产环境验证的完整实现：
import os import re # ⚙️ 配置区（按需修改） directory = r'C:/Users/me/Desktop/wsphp' # 根目录（建议使用原始字符串 r'' 避免转义问题） old_text = r'OLD DATABASE NAME' # 正则模式：需转义特殊字符（如 . $ * 等） new_text = 'NEW DATABASE NAME' # 替换文本 # ? 递归遍历 + 批量替换 for root, dirs, files in os.walk(directory): for filename in files: if filename.lower().endswith('.php'): # 不区分大小写匹配 .php/.PHP filepath = os.path.join(root, filename) # ✅ 关键：构造完整路径 try: # ? 读取文件（自动处理编码，优先 UTF-8，失败则回退 GBK） with open(filepath, 'r', encoding='utf-8') as f: content = f.read() # 若 UTF-8 失败（如含中文的旧文件），尝试 GBK except UnicodeDecodeError: with open(filepath, 'r', encoding='gbk') as f: content = f.read() # ✏️ 执行替换（re.sub 确保全局、安全替换） new_content = re.sub(re.escape(old_text), re.escape(new_text), content) # ? 写回文件（覆盖原文件） with open(filepath, 'w', encoding='utf-8') as f: f.write(new_content) print(f"✓ 已更新: {filepath}") print("n✅ 批量替换完成！")关键注意事项与最佳实践：
- 路径安全：务必使用 os.path.join(root, filename)，不可直接使用 filename；windows 路径分隔符 / 或 均可被 os.path.join 自动适配。
- 编码兼容性：PHP 文件可能采用 UTF-8、GBK 或 ISO-8859-1 编码。代码中加入了 try/except 回退机制，避免解码失败中断流程。
- 正则安全：若 old_text 含正则元字符（如 .、*、$），必须用 re.escape() 包裹，否则将触发意外匹配。若仅需字面量替换，此步不可省略。
- 防误操作：首次运行前，强烈建议：
① 对目标目录做完整备份；
② 将 print(f”✓ 已更新: {filepath}”) 改为 print(f”→ 将替换: {filepath}”) 先预览影响范围；
③ 在小范围子目录中测试验证逻辑。 - 扩展性提示：如需支持更多后缀（.inc, .class.php），可将 if filename.lower().endswith(…) 改为 if any(filename.lower().endswith(ext) for ext in [‘.php’, ‘.inc’])。
该方案兼顾健壮性与可维护性，适用于中小型项目数据库迁移、配置项批量更新等场景，是 devops 自动化脚本的实用基础范式。
立即学习“PHP免费学习笔记（深入）”；