Python3现有API抛出异常的文档在哪？如何查询f.read()的所有异常

你提供的示例代码首先存在基础变量名错误：try代码块中定义的文件对象变量名为file，但else和finally块中调用的是f，仅这个问题就会触发NameError。排除变量名错误的前提下，该段代码还存在逻辑缺陷：如果open执行失败触发异常，文件对象变量不会被创建，finally块中调用close()方法会直接抛出NameError，这也是实际开发中推荐用with语句管理文件对象的核心原因之一。

仅就read方法的调用场景来说，即使open执行成功进入else块，调用read()依然可能抛出异常，你提到的文件打开后被删除的场景确实会触发报错，其他常见触发场景还包括磁盘被卸载、文件权限被修改、读取过程中IO设备故障等。

Python API异常的查询途径 #

• 官方标准库文档对应章节：文件对象read()方法的异常说明收录在官方文档的io模块章节下，文本模式打开的文件属于io.TextIOWrapper类的实例，二进制模式打开的文件属于io.BufferedReader类的实例，对应方法的文档会明确标注所有可能抛出的异常类型及触发条件。Python 3中绝大多数IO相关异常都属于OSError的子类，原IOError已经合并为OSError的别名。
• 内置help()函数：在Python交互式环境中，构造对应类的实例后，执行help(实例.方法名)即可查看该方法的完整说明，包含所有可能抛出的异常信息，比如打开一个文件后执行help(f.read)就能直接看到相关异常说明。
• 标准库源码：所有内置方法的文档字符串和实现逻辑中都会标注异常抛出逻辑，直接查看对应模块的源码可以得到最准确的异常信息。

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