Python中目录已在sys.path仍出现ModuleNotFoundError问题求助

核心原因 #

当你直接执行python3.8 /user/user4769/development/python-utils/company/team/user_utils/main.py时，Python会将**main.py所在的目录**（/user/user4769/development/python-utils/company/team/user_utils）加入sys.path的首位。但你要导入的company.team.user_utils.utils是从顶层包company开始的绝对导入，Python需要在sys.path中找到包含company的目录（即项目根目录/user/user4769/development/python-utils），而此时该目录不在搜索路径里，因此触发ModuleNotFound错误。

两种执行方式的差异 #

1. 直接运行脚本（无-m参数）
   • 脚本所在目录被设为sys.path首位，无法识别上层的company包，因为项目根目录不在搜索路径中。
2. 以模块方式运行（使用-m参数）
   你之前尝试加-m参数可能用法有误，正确的执行方式是从项目根目录运行：

   python3.8 -m company.team.user_utils.main
   

   这种模式下，Python会将**当前工作目录（即项目根目录）**加入sys.path首位，自然能找到company顶层包，导入操作可正常执行。

为什么添加sys.path.append(os.getcwd())有效 #

因为你是从项目根目录执行命令的，os.getcwd()返回的就是项目根目录，将其加入sys.path后，Python就能在该目录下找到company包，因此导入成功。

规范解决方案 #

• 优先推荐以模块方式运行：使用-m参数的方式符合Python包管理规范，无需手动修改sys.path，避免路径依赖问题。
• 若需直接运行脚本：可以通过__file__动态获取项目根目录，避免依赖当前工作目录（防止从其他目录执行时出错），代码示例：

  import os
  import sys
  # 从main.py的绝对路径向上回溯3层，得到项目根目录
  project_root = os.path.dirname(
      os.path.dirname(
          os.path.dirname(os.path.abspath(__file__))
      )
  )
  sys.path.append(project_root)
  

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