### 解决 Python 中 `ImportError` 导入自定义模块问题 当遇到 `ImportError` 错误提示无法解析导入的自定义模块时，通常是因为解释器找不到该模块的位置。以下是几种常见解决方案： #### 1. 修改 PYTHONPATH 环境变量 可以通过设置环境变量来让 Python 找到所需的模块位置。 ```bash export PYTHONPATH=$PYTHONPATH:/path/to/your/module/directory ``` 这会临时增加目录至 Python 的搜索路径中[^1]。 #### 2. 使用相对或绝对路径导入 如果项目结构允许的话，可以尝试使用相对路径或者绝对路径来进行导入操作。 对于相对路径： ```python from .mymodule import MyClass ``` 对于绝对路径，则需先获取当前文件所在目录并将其加入系统路径列表内： ```python import os, sys sys.path.append(os.path.dirname(os.path.abspath(__file__))) from mymodule import MyClass ``` 上述方法适用于某些特定场景下的开发调试阶段，在生产环境中不推荐这样做。 #### 3. 创建包结构 按照标准创建一个完整的 Python 包结构有助于更好地管理依赖关系以及避免此类错误的发生。确保每个子文件夹下都有 `__init__.py` 文件存在，并且整个项目的根目录应该被包含在 `PYTHONPATH` 或者作为工作区的一部分。 例如建立如下结构： ``` myproject/ ├── __init__.py └── subpackage/ ├── __init__.py └── module.py ``` 此时可以直接通过 `from myproject.subpackage.module import something` 来正常引入所需组件。 #### 4. 安装本地模块为可全局访问的形式 利用工具如 setuptools 可以很方便地将自己编写的代码打包成易于分发和使用的软件包形式。完成之后不仅可以在本机上轻松调用这些资源，还可以分享给其他开发者共同维护和发展。 安装过程大致分为三步： - 编写 setup.py 配置脚本； - 构建发行版档案； - 运行 pip 命令完成最终部署。 ```python # setup.py 示例 from setuptools import setup, find_packages setup( name='mypackage', version='0.1dev', packages=find_packages(), license='MIT License' ) ``` 构建与发布指令： ```bash python setup.py sdist bdist_wheel pip install . ``` 以上方式能够有效防止因路径问题而导致的各种异常情况发生。