Django报错ModuleNotFoundError: No module named 'webapp' 求助

项目结构 #

Settings.py配置 #

INSTALLED_APPS = [
    'webapp',
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
]

Apps.py配置 #

class WebappConfig(AppConfig):
    default_auto_field = 'django.db.models.BigAutoField'
    name = 'webapp'

错误信息 #

C:\Users\agent\PycharmProjects\ExampleProj\venv\Scripts\python.exe C:\Users\agent\PycharmProjects\ExampleProj\mysite\manage.py createsuperuser 
Traceback (most recent call last):
  File "C:\Users\agent\PycharmProjects\ExampleProj\mysite\manage.py", line 22, in <module>
    main()
  File "C:\Users\agent\PycharmProjects\ExampleProj\mysite\manage.py", line 18, in main
    execute_from_command_line(sys.argv)
  File "C:\Users\agent\PycharmProjects\ExampleProj\venv\lib\site-packages\django\core\management\__init__.py", line 446, in execute_from_command_line
    utility.execute()
  File "C:\Users\agent\PycharmProjects\ExampleProj\venv\lib\site-packages\django\core\management\__init__.py", line 420, in execute
    django.setup()
  File "C:\Users\agent\PycharmProjects\ExampleProj\venv\lib\site-packages\django\__init__.py", line 24, in setup
    apps.populate(settings.INSTALLED_APPS)
  File "C:\Users\agent\PycharmProjects\ExampleProj\venv\lib\site-packages\django\apps\registry.py", line 91, in populate
    app_config = AppConfig.create(entry)
  File "C:\Users\agent\PycharmProjects\ExampleProj\venv\lib\site-packages\django\apps\config.py", line 193, in create
    import_module(entry)
  File "C:\Users\agent\AppData\Local\Programs\Python\Python39\lib\importlib\__init__.py", line 127, in import_module
    return _bootstrap._gcd_import(name[level:], package, level)
  File "<frozen importlib._bootstrap>", line 1030, in _gcd_import
  File "<frozen importlib._bootstrap>", line 1007, in _find_and_load
  File "<frozen importlib._bootstrap>", line 984, in _find_and_load_unlocked
ModuleNotFoundError: No module named 'webapp'

Process finished with exit code 1

解决方法 #

• 检查应用目录路径：从项目结构看，若webapp和mysite目录同级（即ExampleProj根目录下），需将根目录加入Python识别路径。在settings.py中添加：

  import sys
  from pathlib import Path
  
  BASE_DIR = Path(__file__).resolve().parent.parent.parent  # 调整为ExampleProj根目录
  sys.path.append(str(BASE_DIR))
  

• 确认__init__.py文件：webapp目录下必须存在空的__init__.py文件，否则Python不会将其视为可导入模块。
• 核对应用注册配置：
  • 若webapp是独立应用，保持INSTALLED_APPS中'webapp'的注册方式，且apps.py的name字段为'webapp'。
  • 若webapp是mysite的子应用，需将apps.py的name改为'mysite.webapp'，同时INSTALLED_APPS中注册'mysite.webapp'或'webapp.apps.WebappConfig'。
• 规范命令运行路径：确保在manage.py所在的mysite目录下运行命令，避免路径层级问题导致模块无法找到。

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