【python】指定一个搜索路径 解决ModuleNotFoundError: No module named

ModuleNotFoundError: No module named 指定一个搜索路径

• 例如 ：
  test.py 同目录有一个tools目录，里面有uc.py

from tools.uc 这样就会报错,说找不到 tools模块。

• 这是因为我指定的搜索路径是tools目录，
• 此目录下不存在tools.uc w

分析原因：

从报错信息来看：

ModuleNotFoundError: No module named 'tools.uc'

说明 Python 并没有把 tools 这个文件夹当作一个可导入的 package 来识别，或者说它没有在搜索路径中发现名为 tools.uc 的模块。

你在代码中做了：

tools_dir = os.path.join(current_dir, 'tools')
sys.path.append(tools_dir)
from tools.uc import UcHelper

• sys.path.append(tools_dir) 这一步将 tools 文件夹自身加入了 sys.path，因此 Python 在导入模块时，只会在 tools 目录下寻找 同级的 模块（比如 uc.py），而不会再去找一个名为 tools 的包。

• 换言之，Python 的搜索路径里直接是 tools 这个文件夹的内容，而不是其上级目录。于是 from tools.uc import UcAuth 会失败，因为它想先找到一个叫 tools 的包，再在包里找 uc 模块。

常见的解决方案：

• 改成直接 import uc 或 from uc import UcAuth：
• 既然你已经把 tools 目录本身加入了 sys.path，那就可以直接：

from uc import UcHelper

或者

import uc

使用 uc.UcHelper

把上级目录加入 sys.path 并使用包名导入：
如果你希望保留 from tools.uc import UcHelper这种写法，那么就应该把 action 这一层目录加入到 sys.path 中，而不是 tools 目录本身。例如：

current_dir = os.path.dirname(os.path.abspath(__file__))
sys.path.append(current_dir)  # 把当前脚本所在目录（即 action）加入
from tools.uc import UcAuth

• 这样，Python 在 action 目录下找到了 tools 文件夹，tools 又是一个包(如果你在 tools 下加了 init.py 的话)，就能顺利 import tools.uc。

• 确保 tools 目录内有 init.py 文件（如果你想让它成为一个包）：
  在 Python 3.3+ 以后，目录只要符合一定规范也可以视为包，但是加一个空的 init.py 文件会更明确地告诉 Python “这是一个包”，避免某些情况下的歧义。

总结：

• 如果想用 from tools.uc import UcHelper，请在 sys.path 中加入它的上一级目录（action），并在 tools 目录里加上 init.py。

• 如果只想把 tools 文件夹直接加到 sys.path，那么就用 from uc import UcAuth。

• 任选其一即可让导入正常工作。