ModuleNotFoundError: No module named 'util.util'

### 解决 Python 中 `ModuleNotFoundError: No module named 'util.util'` 错误

当遇到此类错误时，通常意味着 Python 无法找到指定的模块或包。对于特定于 `'util.util'` 的情况，可能是因为路径配置不正确或是该文件夹未被识别为有效的 Python 包。

#### 方法一：确认目录结构并创建初始化文件
为了使某个文件夹成为可导入的 Python 包，在此文件夹内需存在名为 `__init__.py` 文件。这可以是一个空文件，它告诉解释器这是一个合法的包位置[^3]。

project_root/
│
├── main.py          # 主程序入口
└── utils/           # 应作为包处理的文件夹
    ├── __init__.py  # 创建为空即可
    └── util.py      # 实际实现功能的目标脚本

#### 方法二：调整环境变量 PYTHONPATH 或者 sys.path
如果项目结构较为复杂，可以通过设置环境变量 `PYTHONPATH` 来增加额外的搜索路径；另一种方式是在运行前动态修改 `sys.path` 列表来临时加入新的查找地点。

import os, sys
current_dir = os.getcwd()
parent_dir = os.path.dirname(current_dir)
if parent_dir not in sys.path:
    sys.path.append(parent_dir)

from utils import util

#### 方法三：确保安装依赖项（适用于第三方库）
虽然这里讨论的是自定义模块而非外部库的情况，但如果确实涉及到了像 `pymysql`, `requests` 这样的第三方库，则应考虑是否已经完成了必要的安装操作[^1][^2]。

pip install pymysql requests