Windows下rename()无法跨大小写重命名文件，因NTFS/FAT不区分大小写；应改用copy()+unlink()组合实现，Linux/macOS则可直接使用rename()。

PHP rename() 无法跨大小写重命名 Windows 文件？

在 Windows 系统上，rename() 函数对仅大小写不同的文件名（如 file.txt → FILE.TXT）通常会失败并返回 false，且不报错。这不是 PHP 的 bug，而是 Windows 文件系统（NTFS/FAT）本身不区分大小写，内核认为这是“同一文件”，拒绝覆盖式重命名。

Linux/macOS 下 rename() 可以直接改大小写

类 Unix 系统的文件系统原生区分大小写，rename() 能正常工作：

rename('config.php', 'Config.php');

但要注意：如果目标名已存在（哪怕只是大小写不同），仍会失败。安全做法是先检查目标是否存在：

• 用 file_exists() 判断 Config.php 是否已存在
• 若存在，需先 unlink() 或重命名旧文件
• 再执行 rename('config.php', 'Config.php')

Windows 下必须绕过：先复制再删除

可靠方案是手动模拟重命名：用 copy() 创建新大小写名称的副本，确认成功后再 unlink() 原文件：

$old = 'index.html';
$new = 'Index.html';

if (copy
($old, $new)) {
    if (unlink($old)) {
        echo "重命名成功";
    } else {
        echo "删除原文件失败";
    }
} else {
    echo "复制失败";
}

注意点：

• copy() 在 Windows 上支持大小写变更，因为它本质是新建文件
• 务必检查 copy() 返回值，避免 unlink() 错删原文件
• 若文件较大，该操作会短暂占用双倍磁盘空间

批量处理时注意文件系统缓存和权限

批量修改大量文件名大小写（如统一首字母大写）时，容易遇到两个隐藏问题：

• Windows 资源管理器或某些 IDE 会缓存文件列表，改完可能不立即刷新 —— 不是 PHP 没生效，而是界面没更新
• 如果文件被其他进程占用（如 Web 服务器正在读取 style.css），copy() 或 unlink() 会失败，需加 is_writable() 和重试逻辑
• 某些共享环境（如 Docker volume 映射到 Windows）可能表现不一致，建议先在目标环境实测单个文件

最易被忽略的是：不要假设所有系统行为一致 —— 同一段代码在开发机（Windows）和生产机（Linux）上，rename() 的成败逻辑可能完全相反。