### 解决方案 当遇到 `ModuleNotFoundError: No module named 'scripts.example_script'` 的错误时，通常是因为 Python 无法找到指定的模块路径。以下是可能的原因以及解决方案： #### 可能原因分析 1. **模块未安装或不存在**：如果 `'scripts.example_script'` 是一个外部库的一部分，则该库可能尚未被正确安装到当前环境中[^1]。 2. **环境变量配置不正确**：Python 使用 `sys.path` 来查找模块文件。如果目标脚本所在的目录不在 `sys.path` 中，则会引发此错误[^3]。 3. **相对导入问题**：如果是通过相对导入的方式调用模块，而运行入口不符合预期，则可能导致模块不可见。 --- #### 解决方法 ##### 方法一：确认模块是否存在并调整工作目录 确保 `'scripts/example_script.py'` 文件存在于项目结构中，并且其父级目录已加入到 `PYTHONPATH` 或者位于当前的工作目录下。可以通过以下方式验证： ```python import sys print(sys.path) ``` 如果 `'scripts/'` 不在上述列表中，可以手动将其添加至 `sys.path`： ```python import sys sys.path.append('/path/to/your/scripts') import scripts.example_script ``` 注意替换 `/path/to/your/scripts` 为实际路径。 ##### 方法二：创建虚拟环境并重新安装依赖项 有时全局环境中的包管理可能会出现问题，建议使用标准的 `venv` 模块来创建独立的虚拟环境。具体操作如下： ```bash python -m venv my_env source my_env/bin/activate # Linux/MacOS my_env\Scripts\activate # Windows pip install --upgrade pip setuptools wheel ``` 接着，在激活后的虚拟环境中尝试重新安装所需的依赖项。例如： ```bash pip install scipy ``` 这一步骤有助于排除因版本冲突或其他环境因素引起的加载失败问题[^2]。 ##### 方法三：检查命名空间包设置 对于复杂的多层嵌套模块（如 `scripts.example_script`），需确保各中间层级均定义有合法的 `__init__.py` 文件以标记为可识别的 Python 包。即使在较新的 Python 版本中隐式命名空间支持增强，显式的初始化仍然推荐用于兼容性和清晰度提升。 --- ### 示例代码片段 假设存在这样的目录布局： ``` project/ ├── scripts/ │ ├── __init__.py │ └── example_script.py └── main.py ``` 那么可以在 `main.py` 中这样写入测试逻辑： ```python from scripts import example_script example_script.some_function() ``` 同时为了便于调试，也可以临时打印出可用搜索路径： ```python if __name__ == "__main__": import sys print("Current search paths:", sys.path) from scripts import example_script print("Example script loaded successfully.") ``` ---