使用PowerShell基于CSV重命名文件时始终提示路径不存在

一、先查CSV文件的问题 #

• 核对列名匹配度：CSV里的列名要和脚本中调用的变量完全对应，比如脚本用$_.OldName，CSV里就得有OldName列，别出现拼写错误、大小写混乱（虽然PowerShell不敏感，但统一更稳妥）。
• 检查旧文件名/路径的有效性：
  • 路径类型：如果写的是相对路径，脚本运行的工作目录必须是文件所在目录，否则会找不到。建议直接用绝对路径（比如D:\Projects\doc.pdf），避免路径歧义。
  • 特殊字符处理：路径或文件名带空格、中文时，CSV里必须用双引号把整个路径包起来，比如"D:\我的文件\old doc.docx"，不然空格会被当成路径分隔符，导致路径截断。
  • 多余空格：打开CSV文件，检查OldName列的内容前后有没有多余空格，比如" file1.txt "，实际文件名没有空格的话，就会匹配失败。
  • 实际验证：复制CSV里的OldName路径，直接粘贴到文件资源管理器地址栏，看能不能打开文件，能打开才是有效路径。

二、再查PowerShell脚本的问题 #

• 路径逻辑处理：
  • 如果用相对路径，脚本开头先切换到文件所在目录，比如Set-Location "D:\Projects"，确保脚本工作路径和文件路径一致。
  • 扩展名完整性：CSV里的OldName必须包含文件扩展名，比如实际文件是photo.png，CSV里不能只写photo，否则脚本找不到对应的文件。
• 加调试输出：在脚本里加一行Write-Host "正在处理: $($_.OldName) -> $($_.NewName)"，这样能看到脚本实际读取的路径是什么，方便排查是不是CSV解析出了问题。
• 权限与错误捕获：以管理员身份运行PowerShell（如果文件在系统目录或受保护文件夹），脚本里可以加-ErrorAction Stop强制终止并显示详细错误，比如Rename-Item -Path $_.OldName -NewName $_.NewName -ErrorAction Stop，能看到更具体的失败原因。

三、示例修正 #

假设你的CSV内容是：

OldName,NewName
"E:\Docs\old note.txt","E:\Docs\new note.txt"
E:\Docs\pic.jpg,E:\Docs\new_pic.jpg

对应的正确脚本可以是：

# 先切换到文件所在目录（如果用相对路径的话）
# Set-Location "E:\Docs"

Import-Csv .\rename_list.csv | ForEach-Object {
    Write-Host "处理文件: $($_.OldName)"
    # 先检查文件是否存在
    if (Test-Path $_.OldName) {
        Rename-Item -Path $_.OldName -NewName $_.NewName
        Write-Host "重命名成功"
    } else {
        Write-Host "错误：文件 $($_.OldName) 不存在"
    }
}

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