如何按父文件夹名批量重命名子文件？

Question

在批量处理文件时，常遇到需根据父文件夹名称重命名其内部子文件的场景。例如，有多个以项目名称命名的文件夹（如“项目A”、“项目B”），每个文件夹内包含若干份文档，现希望将这些文档统一重命名为“父文件夹名_原文件名”的格式，以便归档管理。然而，手动操作效率低下且易出错。如何使用脚本（如Python、PowerShell或Shell）自动遍历指定目录下的所有子文件夹，并将其内部文件按父文件夹名称进行重命名？同时需避免重复命名和文件覆盖，支持常见文件类型，且保留原扩展名。这是自动化文件管理中一个典型但易出错的技术问题。

Answer 1

批量文件重命名自动化：基于父文件夹名称的智能重命名方案

1. 问题背景与典型场景分析

在企业级文档管理、项目归档或数据预处理流程中，常需对大量分散在不同子目录中的文件进行统一命名规范。例如，某公司有多个以客户名称命名的项目文件夹（如“客户A_合同”、“客户B_报价单”），每个文件夹内含若干Word、PDF或Excel文件。为便于后期检索和版本控制，要求将所有文件重命名为“父文件夹名_原文件名.扩展名”的格式。

该需求看似简单，但涉及以下技术挑战：

• 跨平台兼容性（Windows/Linux/macOS）
• 防止重命名冲突导致文件覆盖
• 保留原始文件扩展名
• 支持递归遍历多层级目录结构
• 可扩展至其他元数据（如创建时间、大小等）集成

2. 解决方案设计原则

为确保脚本的健壮性和可维护性，应遵循以下设计原则：

原则	说明
幂等性	重复执行不产生副作用
原子操作	重命名失败时回滚或跳过
日志记录	输出处理过程便于审计
异常捕获	处理权限不足、路径不存在等情况
扩展名保护	使用标准库函数解析文件名
编码安全	处理中文、特殊字符路径
性能优化	避免内存溢出的大规模文件加载
用户确认机制	提供dry-run模式预览效果

3. Python 实现方案

Python 因其跨平台特性和丰富的标准库成为首选工具。以下是完整实现代码：

import os
import sys
from pathlib import Path

def rename_files_by_parent(root_dir, dry_run=True):
    """
    遍历指定目录下的所有子文件夹，将其内部文件重命名为“父文件夹名_原文件名”
    支持常见文件类型，保留扩展名，避免覆盖
    """
    root = Path(root_dir)
    if not root.exists():
        print(f"错误：路径 {root} 不存在")
        return

    counter = 0
    for folder in root.iterdir():
        if folder.is_dir():
            parent_name = folder.name.replace(" ", "_")  # 清理空格
            for file_path in folder.iterdir():
                if file_path.is_file():
                    suffix = file_path.suffix
                    original_name = file_path.stem
                    new_name = f"{parent_name}_{original_name}{suffix}"
                    new_path = file_path.with_name(new_name)

                    # 检查是否已存在同名文件
                    if new_path.exists():
                        print(f"跳过：{new_path} 已存在")
                        continue

                    if not dry_run:
                        try:
                            file_path.rename(new_path)
                            print(f"重命名: {file_path.name} -> {new_name}")
                        except Exception as e:
                            print(f"重命名失败 {file_path}: {e}")
                    else:
                        print(f"[预览] 将重命名: {file_path.name} -> {new_name}")

                    counter += 1
    print(f"共处理 {counter} 个文件")

# 使用示例
if __name__ == "__main__":
    target_dir = sys.argv[1] if len(sys.argv) > 1 else "./projects"
    rename_files_by_parent(target_dir, dry_run=True)  # 先预览
    # rename_files_by_parent(target_dir, dry_run=False)  # 确认无误后执行

    

4. PowerShell 脚本实现（Windows环境）

对于Windows系统管理员而言，PowerShell是更自然的选择。以下脚本具备相同功能：

# Rename-FilesByParentFolder.ps1
param(
    [string]$RootPath = ".\projects",
    [switch]$DryRun = $true
)

Get-ChildItem -Path $RootPath -Directory | ForEach-Object {
    $folderName = $_.Name -replace ' ', '_'
    Get-ChildItem -Path $_.FullName -File | ForEach-Object {
        $newName = "{0}_{1}" -f $folderName, $_.Name
        $newPath = Join-Path $_.Directory.FullName $newName

        if (Test-Path $newPath) {
            Write-Host "跳过: $newPath 已存在" -ForegroundColor Yellow
            return
        }

        if ($DryRun) {
            Write-Host "[预览] 将重命名: $($_.Name) -> $newName"
        } else {
            try {
                Rename-Item $_.FullName -NewName $newName
                Write-Host "重命名成功: $newName" -ForegroundColor Green
            } catch {
                Write-Error "重命名失败 $($_.Name): $_"
            }
        }
    }
}

    

5. Shell 脚本实现（Linux/macOS）

Bash脚本适用于Unix-like系统，轻量高效：

#!/bin/bash
ROOT_DIR="${1:-./projects}"
DRY_RUN=true

for folder in "$ROOT_DIR"/*/; do
    [[ -d "$folder" ]] || continue
    parent_name=$(basename "$folder" | tr ' ' '_')
    
    for file in "$folder"*; do
        [[ -f "$file" ]] || continue
        filename=$(basename "$file")
        dirname=$(dirname "$file")
        extension="${filename##*.}"
        name="${filename%.*}"
        
        new_name="${parent_name}_${filename}"
        new_path="$dirname/$new_name"
        
        if [[ -e "$new_path" ]]; then
            echo "跳过: $new_path 已存在"
            continue
        fi
        
        if $DRY_RUN; then
            echo "[预览] 将重命名: $filename -> $new_name"
        else
            mv "$file" "$new_path" && echo "重命名: $new_name"
        fi
    done
done

    

6. 流程图：整体处理逻辑

graph TD
            A[开始] --> B{输入根目录}
            B --> C[遍历所有子文件夹]
            C --> D{是否为目录?}
            D -- 是 --> E[获取父文件夹名称]
            D -- 否 --> F[跳过]
            E --> G[遍历目录内所有文件]
            G --> H{是否为文件?}
            H -- 是 --> I[构建新文件名: 父名_原名.扩展]
            H -- 否 --> J[跳过]
            I --> K{目标路径是否存在?}
            K -- 存在 --> L[记录冲突并跳过]
            K -- 不存在 --> M[执行重命名或预览]
            M --> N[记录操作日志]
            N --> O[继续下一个文件]
            O --> G
            G --> P[完成当前文件夹]
            P --> C
            C --> Q[全部完成]
            Q --> R[输出统计结果]

7. 常见陷阱与最佳实践

在实际部署中，开发者常忽略以下细节：

1. 路径中包含特殊字符（如#、&、括号）导致shell解析错误
2. 文件名大小写敏感性差异（Windows vs Linux）
3. 符号链接处理不当引发无限循环
4. 并发访问时的文件锁定问题
5. 长路径超出操作系统限制（尤其Windows 260字符限制）
6. 未处理只读文件属性
7. 日志未持久化，无法追溯历史操作
8. 缺乏进度反馈，大目录处理时用户体验差
9. 未考虑网络驱动器延迟
10. 缺少备份机制，误操作难以恢复