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

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

本文详细介绍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 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。