整理一个目录时，最危险的操作之一，是看到同名文件就直接覆盖。不同设备可能生成相同的编号，相同文件也可能被放进不同的子目录。先把重名项目列出来，再决定如何处理，可以让整理过程更容易核对。下面介绍一个只读取文件信息的 Python 示例，不执行删除、移动或重命名。

![同名文件检查示意](https://developer.qcloudimg.com/http-save/10037525/9a8a019385366660074226d4ea137cc0.jpg)

## 从一个小目录开始

先选一个文件数量不多的目录，例如临时收集的照片副本。不要一开始就扫描整块系统盘：目录范围太大，会让结果难以检查，也更容易遇到没有读取权限的文件夹。扫描过程中尽量暂停其他软件对目录的写入，避免一边生成清单、一边发生内容变化。

## 用文件名分组

Python 标准库的 pathlib 可以遍历路径，collections 中的 defaultdict 可以收集同名项目。下面的例子保留扩展名，并按文件名原样分组。它不会把不同大小写的名称强制合并，这一点在不同文件系统之间尤其需要注意。

```python
from pathlib import Path
from collections import defaultdict

root = Path('sample_files')
groups = defaultdict(list)

if not root.is_dir():
    raise SystemExit('请先准备 sample_files 示例目录')

for path in root.rglob('*'):
    if path.is_file() and not path.is_symlink():
        groups[path.name].append(path.relative_to(root))

for name, paths in sorted(groups.items()):
    if len(paths) > 1:
        print(name)
        for relative_path in sorted(paths):
            print('  ', relative_path)
```

运行前，将示例目录名替换为自己准备的目录，或在脚本所在位置建立 sample_files。结果只列出出现超过一次的文件名，以及它们在根目录之下的位置。没有输出并不代表整个目录一定没有重复内容，它只表示这次扫描没有发现符合分组条件的同名文件。

## 相对路径比单独的名字更有用

假设两个设备都生成了 IMG_0001.jpg，只看文件名无法区分它们。保留手机A/IMG_0001.jpg 与相机B/IMG_0001.jpg 这样的相对路径，才知道每一份来自哪里。相对路径也更方便随目录一起交接，不需要把个人用户名和电脑盘符写进公开说明。

扫描实际工作目录时，还应考虑无法读取、扫描期间被删除以及权限不足等情况。这个基础例子用于演示分组，正式批量工具应明确记录这些异常。不能把跳过的项目悄悄当作已检查，更不能仅靠没有报错就宣称所有文件都一致。

## 同名与重复内容是两回事

同名可能对应完全不同的照片，不同名称也可能对应同一份文件。名称检查用于发现整理冲突；文件大小可以帮助初筛；对稳定文件计算 SHA-256 摘要，可以进一步比较字节内容。三种检查目的不同，不应把任意一项直接当作删除依据。

需要判断实际内容时，最好从每组文件里挑出样本打开查看。照片可能经过裁切，视频可能重新编码，文档可能包含不同修订。这些差异未必能从缩略图或名称看出来。比较前先弄清楚是要保存原始版本，还是准备分享版本。

## 把检查和修改分开执行

先保存清单，再人工确认整理计划，最后才执行移动或重命名。重要资料应留有独立副本，整理后随机选择几份文件，按清单重新找到并打开。这样既能验证新目录是否好用，也能发现整理过程中是否丢失了来源线索。

说明：本文由 AI 辅助整理，代码为只读演示，配图为自制说明图。示例目录和文件名均为虚构。

整理一个目录时，最危险的操作之一，是看到同名文件就直接覆盖。不同设备可能生成相同的编号，相同文件也可能被放进不同的子目录。先把重名项目列出来，再决定如何处理，可以让整理过程更容易核对。下面介绍一个只读取文件信息的 Python 示例，不执行删除、移动或重命名。

用Python列出目录中的同名文件

整理文件前先做只读检查：用 Python 按文件名分组，保留相对路径，区分同名冲突与重复内容。本文提供基础示例，并说明异常记录、人工核对和独立备份的边界。

编程语言

同名文件直接覆盖极易造成数据损失，本页提供只读Python扫描方案，用pathlib和defaultdict分组列出重名文件及相对路径，不执行修改。明确区分同名与重复内容，建议先存清单再人工确认，适合安全整理目录。

文件系统

代码解释

Python

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

用Python列出目录中的同名文件-腾讯云开发者社区-腾讯云

用Python列出目录中的同名文件

用Python列出目录中的同名文件

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐