使用hf_hub_download导入bert_opinion、post模块遇ModuleNotFoundError如何解决？

排查步骤与修复方法 #

1. 确认文件路径与sys.path配置 #

先打印下载文件的实际路径，验证目录是否正确添加到Python的模块搜索路径中：

from huggingface_hub import hf_hub_download
import sys

model_id = 'gauneg/bert-gts-absa-triple'
bert_gts_pretrained = hf_hub_download(repo_id=model_id, filename="bert_opinion.py")
post = hf_hub_download(repo_id=model_id, filename="post.py")

# 打印文件路径，确认所在目录
print(f"bert_opinion.py路径: {bert_gts_pretrained}")
print(f"post.py路径: {post}")

# 两个文件大概率存放在同一目录，只需添加一次目录到sys.path
file_dir = bert_gts_pretrained.rsplit("/", 1)[0]
sys.path.append(file_dir)

# 验证目录是否成功添加
print(f"目录已添加到sys.path: {file_dir}" if file_dir in sys.path else f"目录未添加到sys.path: {file_dir}")

from bert_opinion import BertGTSOpinionTriple
from post import DecodeAndEvaluate

运行后检查两点：

• 两个文件是否处于同一目录
• 该目录是否确实出现在sys.path输出结果中

2. 检查文件名与大小写匹配 #

确认下载后的文件名完全为bert_opinion.py和post.py，无拼写错误或大小写差异（Linux/macOS系统对文件名大小写敏感，若下载文件是Bert_Opinion.py这类变体，会导致导入失败）。

3. 强制刷新模块搜索缓存（可选） #

若确认目录已添加但仍报错，可在sys.path.append之后、导入语句之前添加以下代码，强制刷新Python的模块搜索缓存：

import importlib
importlib.invalidate_caches()

4. 直接从文件路径导入（备选方案） #

如果以上方法都无效，可跳过模块搜索路径，直接从指定文件加载目标类：

from huggingface_hub import hf_hub_download
from importlib.machinery import SourceFileLoader

model_id = 'gauneg/bert-gts-absa-triple'
bert_file = hf_hub_download(repo_id=model_id, filename="bert_opinion.py")
post_file = hf_hub_download(repo_id=model_id, filename="post.py")

# 直接加载文件中的类
BertGTSOpinionTriple = SourceFileLoader("bert_opinion", bert_file).load_module().BertGTSOpinionTriple
DecodeAndEvaluate = SourceFileLoader("post", post_file).load_module().DecodeAndEvaluate

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