`ModuleNotFoundError: No module named 'exceptions'` 错误通常发生在运行从 **Python 2** 迁移过来的旧代码时。在 Python 3 中，`exceptions` 模块已被移除，其功能被整合进了内置的 `builtins` 模块[ref_1][ref_3]。 ### **错误原因分析** 这个错误的核心原因可以归结为以下两点： 1. **直接原因**：代码中包含了 `import exceptions` 语句，或者某个依赖的第三方库内部引用了该模块。 2. **根本原因**： * **代码本身是为 Python 2 编写的**：Python 2 确实有一个 `exceptions` 模块，用于定义标准异常层次结构。Python 3 将其废除，所有异常现在都是 `builtins` 模块的一部分。 * **使用了过时或不兼容的第三方库**：某些古老的、未适配 Python 3 的库可能会在其代码中引用 `exceptions` 模块。 ### **解决方法** 针对不同的原因，解决方案也有所不同。下表总结了主要的解决路径： | 问题场景 | 解决方法 | 核心步骤 | | :--- | :--- | :--- | | **代码自身包含 `import exceptions`** | **代码升级** | 将 `import exceptions` 替换为相应的 Python 3 内置异常。 | | **由 `python-docx` 或 `docx` 安装错误引发** | **检查并重装正确的库** | 卸载 `docx`，安装 `python-docx`。 | | **由其他过时库引发** | **更新或替换依赖库** | 查找引发问题的库，升级到支持 Python 3 的版本，或寻找替代品。 | #### **方法一：升级代码（针对自有代码）** 如果你的代码中直接写有 `import exceptions`，你需要将其移除，并直接使用 Python 3 的内置异常。 **Python 2 旧代码示例（引发错误）：** ```python import exceptions try: # 一些可能引发异常的操作 x = 1 / 0 except exceptions.ZeroDivisionError: # 通过 exceptions 模块引用 print("捕获到除零错误") ``` **升级为 Python 3 的正确代码：** ```python # 直接使用内置异常，无需导入 exceptions try: x = 1 / 0 except ZeroDivisionError: # 直接使用异常类名 print("捕获到除零错误") ``` 所有标准异常（如 `ValueError`, `TypeError`, `KeyError`, `IndexError` 等）都可以直接使用。对于自定义异常，也应继承自 `Exception` 类，而不是 `exceptions.Exception`。 #### **方法二：检查和重装 `python-docx`（常见于文档操作）** 在处理 Word 文档时，这是一个**非常常见**的错误诱因[ref_3]。很多人会错误地安装名为 `docx` 的包，而不是正确的 `python-docx` 包。 1. **检查当前安装**：在终端或命令行中运行以下命令。 ```bash pip list | grep -i docx ``` 如果看到安装了 `docx`（一个完全不同的旧库），那就是问题的根源。 2. **卸载错误的库，安装正确的库**： ```bash # 卸载错误的 docx 包 pip uninstall docx # 安装正确的 python-docx 包 pip install python-docx ``` 之后，在你的代码中，导入语句应使用 `python-docx` 的模块名： ```python # 正确导入方式 from docx import Document # 而不是 import docx (来自错误的包) ``` #### **方法三：更新或替换引发问题的第三方库** 如果错误源自其他第三方库（非 `python-docx`），你需要定位到它并更新。 1. **定位问题库**： 运行你的程序，完整的错误堆栈跟踪通常会指出是哪个文件（属于哪个库）在尝试导入 `exceptions`。例如，堆栈中可能包含类似 `.../some_old_library/core.py, line 5, in <module>` 的信息。 2. **尝试升级库**： 使用 `pip` 尝试将该库升级到最新版本。 ```bash pip install --upgrade 问题库名 ``` 3. **寻找替代方案**： 如果该库已经年久失修，不再维护，你需要寻找一个功能类似且支持 Python 3 的替代库。 ### **总结与建议** 遇到 `ModuleNotFoundError: No module named 'exceptions'`，首先应判断错误的来源。**对于大多数现代 Python 3 项目，最常见的原因是混淆了 `docx` 和 `python-docx` 库**。优先使用方法二进行排查和修复。如果是维护旧项目，则需要根据堆栈信息，使用方法一或方法三对特定代码或依赖进行升级。始终保持你的项目依赖在 Python 3 的兼容环境下是解决问题的根本。