### 解决 Python 中无法导入自定义包的问题 当遇到 `import` 自定义包失败的情况时，通常是因为模块路径未被正确识别或环境配置存在问题。以下是可能的原因及其解决方案： #### 1. 路径问题 如果目标文件夹不在当前解释器的搜索路径中，则会引发 ImportError。可以通过以下方法验证并修复此问题。 - 使用 `sys.path` 查看当前的模块搜索路径列表[^1]： ```python import sys print(sys.path) ``` - 如果自定义包所在的目录未包含在此列表中，可以手动将其添加到 `sys.path` 中： ```python import sys sys.path.append('/path/to/your/package') ``` #### 2. 文件结构不规范 Python 需要特定的文件结构来识别包和子模块。确保项目遵循标准布局，例如创建一个名为 `__init__.py` 的初始化文件以便于将文件夹标记为可导入的包。 假设有一个如下所示的目录树： ``` my_package/ __init__.py module_a.py subpackage_b/ __init__.py module_c.py ``` 在这种情况下，可以从顶层调用 `module_a` 或者通过相对导入访问 `subpackage_b.module_c`。 #### 3. 环境变量设置错误 有时开发人员会在不同的虚拟环境中工作而忘记激活正确的环境。确认正在使用的 Python 版本以及安装依赖项的位置是否匹配当前运行脚本所处的环境[^2]。 - 列出已安装库以检查所需软件包是否存在： ```bash pip list ``` - 安装缺失的第三方库至对应位置（如有必要）： ```bash pip install some-package --upgrade ``` #### 4. 命名冲突 另一个常见问题是本地命名与其他内置名称或者外部库发生重叠。尝试更改潜在引起歧义的名字或将测试代码移入独立的新空间重新执行一次实验观察效果如何变化。 --- ### 示例修正方案 下面提供了一个简单的例子展示如何处理上述提到的一些情况: ```python try: from my_custom_module import MyClass except ModuleNotFoundError as e: print(f"Error occurred: {e}") # 动态调整系统路径作为临时措施解决问题 import os, sys current_dir = os.getcwd() parent_dir = os.path.dirname(current_dir) sys.path.insert(0,parent_dir) try: from my_custom_module import MyClass instance = MyClass() print("Successfully imported and instantiated.") except Exception as ex: raise RuntimeError('Failed to resolve after modifying path') from ex ```