Python导入navigator.py报错ModuleNotFoundError: No module named 'navigator'求助

常见核心原因 #

• 文件名大小写不匹配：你导入语句中写的模块名是navigator，但实际文件命名是Navigator.py（首字母大写），Linux、Mac系统对文件名大小写敏感，会直接识别为不同文件，Windows系统虽然大小写不敏感，也可能因IDE配置触发该错误。
• 两个文件不在同级目录：如果renameFrame.py和Navigator.py没有存放在同一个文件夹下，Python默认的模块搜索路径无法扫描到目标文件。
• 项目根目录未加入Python搜索路径：运行代码时当前工作目录不对，或是IDE没有将项目根目录标记为源码目录，导致Python无法定位到模块位置。

对应解决办法 #

1. 优先修正大小写问题
   将导入语句修改为：

from Navigator import Navigator

或者将文件名修改为全小写的navigator.py（符合Python模块命名的PEP8规范）。

2. 若两文件不在同级目录
   在renameFrame.py的导入语句前添加路径配置代码，将模块所在目录加入搜索路径：

import sys
import os
# 此处替换为Navigator.py所在目录的相对/绝对路径
sys.path.append(os.path.join(os.path.dirname(os.path.abspath(__file__)), "你的Navigator所在目录路径"))
from Navigator import Navigator

3. IDE配置修正（适用于PyCharm等IDE）
   右键点击项目根目录，选择「Mark Directory as」→「Sources Root」，IDE会自动将根目录加入Python模块搜索路径。

内容的提问来源于stack exchange，提问作者Tanmay Chavan