优化PowerShell中插入硬编码值的Rename-Item重命名脚本

优化后的完整脚本 #

# 配置参数
$rootFolder = 'C:\Users\Documents\My Documents\PowerShell\Test'
$targetSubfolder = '2023'
$excludeSubfolder = 'Misc'
$fileExtension = '.xlsx'
$insertText = 'USA'

# 递归查找符合条件的文件：位于2023子文件夹下、排除Misc子文件夹、扩展名为xlsx、文件名（不含扩展名）包含4个分隔符'.'
Get-ChildItem -Path $rootFolder -Filter "*$fileExtension" -Recurse | Where-Object {
    # 验证文件所在路径包含2023子文件夹，且不包含Misc子文件夹
    $_.DirectoryName -match [regex]::Escape($targetSubfolder) -and 
    $_.DirectoryName -notmatch [regex]::Escape($excludeSubfolder) -and
    # 验证文件名（不含扩展名）恰好有4个分隔符'.'，对应原命名规则的5段内容
    ($_.BaseName.Split('.')).Count -eq 5
} | Rename-Item -NewName {
    # 使用正则替换在第4个'.'后插入指定文本，简化字符串拼接逻辑
    $_.Name -replace '^(([^.]+\.){4})', "`$1$insertText."
} -WhatIf

核心优化点 #

• 参数语义化：统一变量命名规则，提升脚本可读性与可维护性
• 精准条件过滤：
  • 合并多层遍历为单管道流程，减少IO操作开销
  • 新增文件名格式校验：确保仅处理不含扩展名时恰好有4个.的文件，避免误操作
  • 准确排除Misc子文件夹内的文件，避免遍历无关目录
• 高效字符串处理：
  • 用-replace结合正则表达式替代重复的Split拼接操作，代码更简洁且执行效率更高
  • 正则表达式^(([^.]+\.){4})精准匹配文件名前4个以.分隔的片段，替换时直接插入USA实现需求
• 安全匹配处理：使用[regex]::Escape()处理路径中的特殊字符，避免正则匹配异常

内容的提问来源于stack exchange，提问作者cthorn112