Django与pylint模块引用不一致问题求助

你的问题核心是错误地给项目根目录添加了__init__.py，导致Python路径和Pylint的包识别逻辑产生冲突。

先理清楚你的项目结构：django-admin startproject foo生成的标准结构是：

foo/  # 项目根目录，不是Python包
├── manage.py
└── foo/  # 真正的Python包（Django项目包）
    ├── __init__.py
    ├── settings.py
    ...

你手动给外层的foo/目录加了__init__.py，这会让Pylint误以为外层foo是一个Python包。当你在命令里写import foo.models时，Pylint会去外层foo/找models.py，但你的models.py实际在内层foo/foo/里，自然报错。

而manage.py运行时，Django会自动把项目根目录（外层foo/）添加到sys.path里，此时foo指的是内层的Python包，所以import foo.models能正常找到文件。如果改成import foo.foo.models，Pylint会认为这是外层foo包下的foo子包，检测通过，但manage.py运行时，sys.path里的顶层包是内层foo，找不到foo.foo这个结构，就会报模块不存在。

解决步骤： #

• 删除外层foo/__init__.py：项目根目录不需要是Python包，Django会自动处理路径，这个文件完全多余，也是问题的源头。
• 保留或调整命令里的导入语句：
  • 绝对导入：保留import foo.models或者写成from foo.models import ...，删除外层__init__.py后，Pylint能正确识别内层foo是顶层包，和manage.py的逻辑一致。
  • 相对导入：因为命令文件在foo.management.commands包下，也可以用相对导入：from ...models import ...（三个点表示向上跳两级目录，从commands到management再到foo包，找到models）。
• 调整Pylint运行命令：从项目根目录（外层foo/）执行，同时简化settings模块路径：

  cd foo
  ../venv/bin/pylint --load-plugins pylint_django --django-settings-module=foo.settings --errors-only foo
  

这样调整后，manage.py运行和Pylint检测就能同时正常工作了。

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