### Python 导入同级目录模块时出现 `ModuleNotFoundError` 的解决方案 当尝试导入位于同一目录下的模块时，如果遇到 `ModuleNotFoundError: No module named 'xxx'` 错误，这通常是由于Python解释器未能正确识别当前工作目录或包结构所致[^2]。 #### 方法一：调整环境变量 一种常见的方式是在运行脚本之前修改系统的PYTHONPATH环境变量，使其包含项目根目录。这样可以确保Python能够找到并加载所需的模块。 对于Windows操作系统，在命令行中执行如下指令： ```batch set PYTHONPATH=%PYTHONPATH%;C:\path\to\your\project\ ``` 而对于Linux/MacOS，则可以在终端里输入： ```bash export PYTHONPATH=$PYTHONPATH:/path/to/your/project/ ``` #### 方法二：使用绝对路径代替相对路径 另一种简单的方法就是采用绝对路径来进行模块的引入操作。假设项目的文件夹结构如下： ``` my_project/ │ ├── main.py └── utils/ └── helper.py ``` 此时可以在`main.py`里面像下面这样做： ```python from my_project.utils.helper import some_function ``` 不过这种方法不够灵活，并且不利于维护大型应用程序；因此一般只适用于小型项目或者临时测试用途。 #### 方法三：利用 `-m` 参数启动程序 还可以借助于Python自带的`-m`参数来指定入口点所在的包名而非具体文件位置。继续以上述例子为例，应该进入到`my_project`所在父层之后再执行以下命令： ```bash python -m my_project.main ``` 此方式下即使不设置额外的工作区也能正常访问子文件夹内的资源了。 #### 方法四：修正IDE配置 如果是基于集成开发环境(IDE)，比如PyCharm、VSCode等工具进行编码的话，还需要确认其内部设定是否合理。特别是某些情况下默认不会把整个工程视作单一逻辑单元处理，从而影响到了依赖关系解析过程。针对这类情形可参照官方文档说明适当调整选项以满足实际需求[^3]。 #### 示例代码展示 假设有两个处于相同层次上的`.py`源码片段——分别是`module_a.py`和`module_b.py`，以及一个用来调用它们功能的核心控制台应用`app.py`: ```python # app.py if __name__ == '__main__': from .module_a import func_in_module_a from .module_b import func_in_module_b print(func_in_module_a()) print(func_in_module_b()) ``` 请注意上述语法仅限于作为顶层包的一部分被其他地方引用的时候有效，单独直接双击打开则会触发异常提示。为了绕过这一限制，建议按照前面提到过的几种思路择优选取合适策略加以应对。