Django项目初始化文件缺失求助：如何重建文件启动开发服务器

先找问题根源 #

• 大概率是你在已有同名文件的目录里执行了django-admin startproject命令，导致Django没生成完整项目结构；也可能是命令格式写错了（比如误写为django-admin startproject .且目录非空）。

两种解决方式：重新创建或手动补全 #

方式一：重新生成完整项目（最省心） #

1. 删除之前生成的单个错误文件，切换到一个空目录下。
2. 执行正确的创建命令：

django-admin startproject 你的项目名

比如想创建名为myblog的项目，就运行django-admin startproject myblog。
3. 进入生成的项目根目录，执行python manage.py runserver，验证服务器能否正常启动。

方式二：手动补全缺失文件（不想重新创建时用） #

正常的Django初始项目结构如下：

你的项目名/
    manage.py
    你的项目名/
        __init__.py
        settings.py
        urls.py
        asgi.py
        wsgi.py

按以下步骤创建文件：

1. 在根目录创建manage.py，复制以下内容（注意替换你的项目名.settings里的项目名）：

#!/usr/bin/env python
"""Django's command-line utility for administrative tasks."""
import os
import sys

def main():
    os.environ.setdefault('DJANGO_SETTINGS_MODULE', '你的项目名.settings')
    try:
        from django.core.management import execute_from_command_line
    except ImportError as exc:
        raise ImportError(
            "Couldn't import Django. Are you sure it's installed and "
            "available on your PYTHONPATH environment variable? Did you "
            "forget to activate a virtual environment?"
        ) from exc
    execute_from_command_line(sys.argv)

if __name__ == '__main__':
    main()

2. 创建和根目录同名的子目录（比如你的项目名/），在里面创建以下文件：

• __init__.py：空文件即可
• settings.py：复制下面的基础配置（替换你的项目名和Django版本号X.X.X）：

"""
Django settings for 你的项目名 project.

Generated by 'django-admin startproject' using Django X.X.X.
"""

from pathlib import Path

BASE_DIR = Path(__file__).resolve().parent.parent

SECRET_KEY = 'django-insecure-随便写一串字符就行，开发环境不用太复杂'
DEBUG = True
ALLOWED_HOSTS = []

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

MIDDLEWARE = [
    'django.middleware.security.SecurityMiddleware',
    'django.contrib.sessions.middleware.SessionMiddleware',
    'django.middleware.common.CommonMiddleware',
    'django.middleware.csrf.CsrfViewMiddleware',
    'django.contrib.auth.middleware.AuthenticationMiddleware',
    'django.contrib.messages.middleware.MessageMiddleware',
    'django.middleware.clickjacking.XFrameOptionsMiddleware',
]

ROOT_URLCONF = '你的项目名.urls'

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [],
        'APP_DIRS': True,
        'OPTIONS': {
            'context_processors': [
                'django.template.context_processors.debug',
                'django.template.context_processors.request',
                'django.contrib.auth.context_processors.auth',
                'django.contrib.messages.context_processors.messages',
            ],
        },
    },
]

WSGI_APPLICATION = '你的项目名.wsgi.application'

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': BASE_DIR / 'db.sqlite3',
    }
}

AUTH_PASSWORD_VALIDATORS = [
    {
        'NAME': 'django.contrib.auth.password_validation.UserAttributeSimilarityValidator',
    },
    {
        'NAME': 'django.contrib.auth.password_validation.MinimumLengthValidator',
    },
    {
        'NAME': 'django.contrib.auth.password_validation.CommonPasswordValidator',
    },
    {
        'NAME': 'django.contrib.auth.password_validation.NumericPasswordValidator',
    },
]

LANGUAGE_CODE = 'zh-hans'
TIME_ZONE = 'Asia/Shanghai'
USE_I18N = True
USE_TZ = True

STATIC_URL = 'static/'
DEFAULT_AUTO_FIELD = 'django.db.models.BigAutoField'

• urls.py：

"""你的项目名 URL Configuration"""
from django.contrib import admin
from django.urls import path

urlpatterns = [
    path('admin/', admin.site.urls),
]

• wsgi.py：

"""
WSGI config for 你的项目名 project.
"""
import os
from django.core.wsgi import get_wsgi_application

os.environ.setdefault('DJANGO_SETTINGS_MODULE', '你的项目名.settings')
application = get_wsgi_application()

• asgi.py：

"""
ASGI config for 你的项目名 project.
"""
import os
from django.core.asgi import get_asgi_application

os.environ.setdefault('DJANGO_SETTINGS_MODULE', '你的项目名.settings')
application = get_asgi_application()

3. 所有文件创建完成后，进入根目录执行python manage.py runserver，测试服务器是否正常启动。

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