Python项目导入filemgr模块报错：No module named 'filemgr'求助

问题描述 #

我的Python项目中有base_file.py（注：原文件名中的括号应为笔误，推测实际是base_file.py），尝试导入filemgr.py时触发报错。导入代码如下：

import os
import sys
sys.path.append('C:\\Users\\XXXXX\\Google Drive\\Stratham Green\\Electric\\Python Projects\\uiProject\\fileManager')
import filemgr

运行后报错：

No module named 'filemgr'

当前sys.path包含以下路径：

C:\Users\XXXXX\Google Drive\Stratham Green\Electric\Python Projects\uiProject （存放base_file.py）
C:\Users\XXXXX\Google Drive\Stratham Green\Electric\Python Projects\uiProject\fileManager （存放filemgr.py）

已尝试的操作：

• 将filemgr.py移至base_file.py所在目录外
• 使用相对路径导入
• 测试多种导入语句：import filemgr、from filemgr import [函数名]、from filemgr import *
• 尝试将目标目录设为Python包（添加__init__.py）
• 额外测试：复制filemgr.py并重命名为deleteme.py，放入所有sys.path目录下，依然无法识别

排查与解决步骤 #

1. 修正路径字符串转义 #

Windows路径的反斜杠\需正确处理，可改用原始字符串（路径前加r）避免转义异常，替换后的代码：

sys.path.append(r'C:\Users\XXXXX\Google Drive\Stratham Green\Electric\Python Projects\uiProject\fileManager')

2. 验证路径是否成功添加 #

在导入前打印完整sys.path，确认目标路径确实存在：

import sys
print("添加前的sys.path：", sys.path)
sys.path.append(r'C:\Users\XXXXX\Google Drive\Stratham Green\Electric\Python Projects\uiProject\fileManager')
print("添加后的sys.path：", sys.path)
import filemgr

若打印结果中没有目标路径，检查路径拼写是否完全正确（注意空格、文件夹名称大小写）。

3. 检查文件命名与扩展名 #

• 确认filemgr.py的扩展名确实是.py，避免系统隐藏扩展名导致实际为filemgr.py.txt（可在文件夹选项中开启「显示文件扩展名」检查）
• 确保文件名拼写完全匹配，比如是否误写为file_mgr.py

4. 按包规范导入 #

在fileManager目录下添加空的__init__.py文件（提升兼容性），然后通过包名导入：

sys.path.append(r'C:\Users\XXXXX\Google Drive\Stratham Green\Electric\Python Projects\uiProject')
from fileManager import filemgr

5. 验证Python解释器环境 #

确认运行代码的Python解释器与设置路径的解释器为同一环境（比如避免混用虚拟环境和系统Python），可打印解释器路径验证：

import sys
print(sys.executable)

6. 清理缓存文件 #

删除项目目录下的__pycache__文件夹，清除Python生成的.pyc缓存文件后重新运行代码。

7. 尝试根目录绝对导入 #

将项目根目录加入sys.path，直接从根路径导入：

import sys
sys.path.append(r'C:\Users\XXXXX\Google Drive\Stratham Green\Electric\Python Projects')
from uiProject.fileManager import filemgr

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