.NET System.IO命名空间文档异常疑问：抛出范围与内部异常

问题1：System.IO命名空间文档中列出的异常，是否是使用该命名空间内方法时可能抛出的唯一异常？ #

不是。文档里列出的只是API设计阶段明确定义、需要开发者针对性处理的异常，实际运行时还会出现不少未被文档标注的异常，比如：

• 线程强制终止时抛出的ThreadAbortException，任何正在执行的方法都可能遇到，不会在单个方法文档里逐一说明
• 系统内存耗尽时的OutOfMemoryException，只要涉及内存分配的操作都可能触发，属于CLR层面的通用异常
• 如果方法内部调用了第三方扩展或非官方实现的代码，还可能出现文档未覆盖的自定义异常

问题2：查看.NET的System.IO文档时，能否假设该命名空间内方法仅会抛出文档中列出的异常，而其他可能出现但未在该文档中列出的异常均为已文档异常的内部异常？ #

绝对不能做这种假设。未被文档列出的异常不一定是已标注异常的内部异常，常见情况包括：

• 前面提到的ThreadAbortException、OutOfMemoryException这类运行时/CLR级别的异常，都是直接抛出的，并非任何已文档化异常的内部异常
• .NET版本迭代中，方法实现细节调整可能新增异常，但文档未及时更新
• 跨平台场景下，不同操作系统的底层IO逻辑可能抛出平台特有异常，这类异常往往不会被统一到官方文档里

这个结论同样适用于.NET的其他所有命名空间——官方文档只会聚焦于开发者需要主动处理的API约定异常，而运行时底层、系统级别的通用异常不会在每个方法文档里重复罗列。

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