Python os.rename() 重命名文件与目录详解及异常处理

Ruby
Ruby
发布时间:2026-10-13 | 4人浏览过
原创

本文详细介绍Python中os.rename()方法的使用,包括语法、参数及返回值。通过实验演示如何重命名文件和目录,并重点分析当目标路径已存在或源路径不存在时抛出的OSError错误(如Error 2和Error 183),帮助开发者避免覆盖冲突和路径错误。

概述

os.rename() 函数主要用于将文件或目录从源路径 src 重命名为目标路径 dst。需要注意的是,如果目标路径 dst 已经存在且为一个目录,该操作将抛出 OSError 异常。

语法

rename() 方法的标准调用格式如下所示:

os.rename(src, dst)

参数

src:指定需要修改名称的原始文件或目录路径。

dst:指定重命名后的新文件或目录路径。

返回值

该方法执行成功后不返回任何值(None)。

该方法支持对文件及目录进行重命名操作。

若 src 参数指向的文件或目录不存在,程序会报错。

若 dst 参数指向的文件或目录已存在,同样会报错。

实验方法:

在当前工作目录下创建一个名为 testDir 的目录。

在 testDir 目录下创建一个名为 123.txt 的文本文件。

在 testDir 目录下再创建一个名为 ttDir 的子目录。

测试代码如下:

# -*- coding:utf-8 -*-

import os


srcDir = './testDir/ttDir'

dstDir = './testDir/hhDir'

try:
 os.rename(srcDir,dstDir)
except Exception as e:
 print e
 print 'rename dir fail\r\n'
else:
 print 'rename dir success\r\n'

srcFile = './testDir/123.txt'

dstFile = './testDir/555.txt'

try:
 os.rename(srcFile,dstFile)
except Exception as e:
 print e
 print 'rename file fail\r\n'
else:
 print 'rename file success\r\n'



print('END')

第一次运行结果如下:

rename dir success

rename file success

END

Process finished with exit code 0

此时,目录 ttDir 已成功重命名为 hhDir。

文件 123.txt 已成功重命名为 555.txt。

再次执行代码:

运行结果如下:

[Error 2] 
rename dir fail

[Error 2] 
rename file fail

END

Process finished with exit code 0

由于之前的文件和目录已被重命名,原路径对应的对象已不存在,因此操作失败。

第三次运行:

在之前的基础上:

重新新建文件 123.txt 和目录 ttDir。

这样 testDir 的目录布局如下:

执行代码:

运行结果如下:

[Error 183] 
rename dir fail

[Error 183] 
rename file fail

END

Process finished with exit code 0

错误原因在于:目标路径下已存在同名文件或目录,os.rename() 不会自动覆盖现有文件,从而引发冲突。

以上这篇Python os.rename() 重命名目录和文件的示例就是小编分享给大家的全部内容了,希望能给大家一个参考,也希望大家多多支持本站。

本站声明

本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。

Python 相关产品和应用

全部下载

专题列表