使用os.rename批量重命名文件时计数器起始值异常问题排查

问题现象 #

• 执行批量重命名脚本后，文件命名从photo_02.jpg开始，而非预期的photo_01.jpg，但循环内打印的计数器明确从1开始
• 文件夹实际有68个目标文件，但os.listdir()返回的列表长度为70，重命名后文件数量仍为68

原始代码 #

import os

path = 'spanish_pages_photos/'
pathContents = os.listdir(path)

pathContents.sort()
counter = 0
list = []
for i in pathContents:
    counter += 1
    print(counter)
    os.rename(f'{path}{i}', f'{path}photo_0{counter}.jpg')

问题根源 #

1. 隐藏/系统文件被计入列表
   os.listdir()会返回目录下所有文件，包括系统自动生成的隐藏文件（比如Mac的.DS_Store、Windows的Thumbs.db）或临时文件。这些文件会被纳入循环计数，但由于系统保护或文件属性，重命名操作可能失败或生成的文件处于隐藏状态，导致你看不到photo_01.jpg——它可能是被重命名后的隐藏文件，或者重命名时直接被系统忽略，计数器却已经+1，后续有效文件从2开始编号。

2. 文件列表包含非目标文件/文件夹
   如果目录内存在文件夹或非.jpg格式的文件，它们会被os.listdir()纳入列表，但重命名时可能因为权限或文件类型问题无法完成操作，同样会占用计数器，导致有效文件的起始编号偏移。

3. 命名冲突导致覆盖
   如果目录原本就存在photo_01.jpg这类命名的文件，当计数器到1时，脚本会把某个原始文件重命名为photo_01.jpg，但这个新命名的文件会留在目录中，原始的photo_01.jpg可能被覆盖，最终你看到的第一个有效文件是编号2的。

解决方案 #

1. 过滤目标文件，排除无效条目 #

只处理.jpg格式的文件，并排除以.开头的隐藏文件，确保循环只针对你需要重命名的文件：

import os

path = 'spanish_pages_photos/'
# 过滤规则：仅保留jpg文件，排除隐藏文件
target_files = [
    filename for filename in os.listdir(path)
    if filename.lower().endswith('.jpg') and not filename.startswith('.')
]
target_files.sort()

counter = 0
for filename in target_files:
    counter += 1
    # 使用格式化字符串处理两位数编号，避免出现photo_010.jpg这类错误命名
    new_name = f'photo_{counter:02d}.jpg'
    os.rename(os.path.join(path, filename), os.path.join(path, new_name))
    print(f'Renamed: {filename} -> {new_name}')

2. 避免命名冲突 #

重命名前先将所有原始文件移到临时目录，再批量重命名后移回，防止覆盖：

import os
import shutil

path = 'spanish_pages_photos/'
temp_path = os.path.join(path, 'temp_backup')
os.makedirs(temp_path, exist_ok=True)

# 先备份所有目标文件到临时目录
target_files = [f for f in os.listdir(path) if f.lower().endswith('.jpg') and not f.startswith('.')]
for f in target_files:
    shutil.move(os.path.join(path, f), os.path.join(temp_path, f))

# 从临时目录读取文件并重命名
temp_files = sorted(os.listdir(temp_path))
counter = 0
for filename in temp_files:
    counter += 1
    new_name = f'photo_{counter:02d}.jpg'
    shutil.move(os.path.join(temp_path, filename), os.path.join(path, new_name))

# 删除临时目录
os.rmdir(temp_path)

3. 使用os.scandir更精准获取文件 #

os.scandir可以获取文件的详细属性，能更准确区分文件和文件夹，避免误处理目录：

import os

path = 'spanish_pages_photos/'
target_files = []
with os.scandir(path) as entries:
    for entry in entries:
        # 仅处理文件、jpg格式、非隐藏文件
        if entry.is_file() and entry.name.lower().endswith('.jpg') and not entry.name.startswith('.'):
            target_files.append(entry.name)
target_files.sort()

counter = 0
for filename in target_files:
    counter += 1
    new_name = f'photo_{counter:02d}.jpg'
    os.rename(os.path.join(path, filename), os.path.join(path, new_name))

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