### 导入位于子目录下的模块或包 在 Python 中，可以通过多种方式导入位于子目录中的模块或包。以下是几种常见的方法： #### 方法一：修改 `sys.path` 通过向 `sys.path` 添加子目录路径，可以使得该子目录被识别为可导入的路径。 ```python import sys import os # 假设当前脚本所在目录有一个名为 'subdir' 的子目录 current_dir = os.path.dirname(os.path.abspath(__file__)) subdir_path = os.path.join(current_dir, 'subdir') sys.path.append(subdir_path) # 现在可以从 subdir 下面导入模块 my_module import my_module # 这里假设存在一个名为 my_module.py 的文件[^1] ``` 这种方法适用于临时调整环境变量的情况，但需要注意的是，在程序结束运行后，这种更改不会保留到全局环境中。 #### 方法二：利用相对导入 如果项目结构清晰定义了一个顶层包，则可以在内部使用 **相对导入** 来访问其他子模块或子包的内容。例如，对于如下目录结构: ``` project/ │ ├── main.py └── package/ ├── __init__.py └── submodule.py ``` 在 `main.py` 文件中可以直接执行以下操作来加载来自 `package/submodule.py` 的功能： ```python from package.submodule import function_name # 使用绝对导入的方式[^3] function_name() ``` 而在同一个包内的不同模块之间也可以采用相对导入的形式完成相互调用： ```python from .another_submodule import another_function # 相对导入形式[^3] ``` 注意这里的小圆点表示相对于当前模块的位置来进行查找。 #### 方法三：ZIP 归档支持 当某些资源被打包成压缩文件时（比如 `.zip`），仍然能够借助内置机制实现对其内嵌 python 脚本的成功引入。只要确保目标 zip 文件已经加入到了系统的搜索路径之中即可自动生效此特性[^2]。 #### 方法四：处理常见错误场景 有时会遇到由于命名冲突或者配置不当而导致无法正常载入预期组件的现象。例如尝试直接作为独立脚本来启动某个属于更大整体架构一部分的小型单元测试片段就可能触发异常提示找不到关联依赖项等问题[^5]。此时应考虑重构代码逻辑使其更符合标准库规范要求；另外还需确认是否正确设置了 PYTHONPATH 变量以便覆盖默认行为并扩展可用范围[^1]。 #### 示例代码展示 下面给出一段综合运用上述技巧的例子供参考学习之用： ```python # Suppose we want to add a subdirectory named 'lib' import sys import os script_directory = os.path.dirname(os.path.realpath('__file__')) lib_path = os.path.join(script_directory, 'lib') if lib_path not in sys.path: sys.path.insert(0, lib_path) # Add at beginning so our version takes precedence over system ones. try: from example_package.example_module import ExampleClass except ImportError as e: print(f"Failed importing due to {e}") else: instance = ExampleClass() instance.do_something() finally: pass ```