克隆GitHub项目后运行main.py无法识别同目录entity2rec类

按优先级从高到低逐一排查即可覆盖绝大多数同类导入报错：

• 核对目录结构匹配性
  先确认entity2rec的实际存放形式：
  • 如果是独立的entity2rec.py文件与main.py处于同一层级，无需额外目录配置
  • 如果是单独的文件夹存放entity2rec相关代码，必须在该文件夹内创建空的__init__.py文件，Python才会将其识别为可导入的包
    禁止出现entity2rec类被存放在深层子目录、main.py却不带路径直接导入的写法。
• 修正运行路径与导入逻辑
  大部分同类报错来自运行时的工作目录错位：
  • 优先在main.py所在的目录下执行python main.py，不要从项目上层目录直接调用深层路径下的main.py脚本
  • 如果必须从上层目录运行脚本，可在main.py的最开头手动将当前脚本所在目录加入Python模块搜索路径，避免搜索路径偏移：

    import sys, os
    # 获取当前main.py的绝对路径所在目录，追加到模块搜索列表
    current_script_dir = os.path.dirname(os.path.abspath(__file__))
    if current_script_dir not in sys.path:
        sys.path.append(current_script_dir)
    

  • 导入语句需匹配运行方式：直接单文件运行时写import entity2rec即可，以模块形式从项目根目录运行时，才需要使用带相对导入前缀的写法。
• 排查环境与命名冲突
  • 确认已激活项目对应的虚拟环境，避免用全局解释器跨路径加载文件
  • 检查是否存在第三方库与本地entity2rec重名的情况，可在代码中打印sys.path查看模块搜索优先级，确认导入时实际加载的文件位置是否为本地的entity2rec文件，而非其他路径下的同名资源。
• 验证模块本身可加载性
  如果以上路径、环境配置均正确，单独执行python entity2rec.py验证文件本身是否存在语法错误——文件存在语法问题时，Python也会抛出“无法识别对应类”的报错，而不会直接提示语法异常。

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