settings.py 是配置中心而非启动入口，Django 通过 django.setup() 或 manage.py 加载它；urls.py 是 URL 匹配表，负责请求分发；wsgi.py 是部署时 WSGI 协议胶水层；manage.py 是命令行配置封装。
settings.py 是配置中心，不是启动入口
很多人以为改了 settings.py 就能立刻生效，其实它只是被其他模块导入读取的配置容器。Django 启动时不会直接执行它，而是由 django.setup() 或命令行工具（如 manage.py runserver）按需加载。
常见错误现象：ImportError: No module named 'myapp'，往往是因为 INSTALLED_APPS 里写了错路径，或没把 app 所在目录加进 PYTHONPATH；DEBUG = False 后静态文件 404，其实是没配 STATIC_ROOT 和没运行 python manage.py collectstatic。
-
SECRET_KEY必须在生产环境换掉，不能用默认值或硬编码在代码里 -
DATABASES的ENGINE值要写全，比如'django.db.backends.postgresql'，少个postgresql就报django.core.exceptions.ImproperlyConfigured - 环境差异建议拆成
settings/base.py+settings/production.py，用python manage.py runserver --settings=myproject.settings.production指定
urls.py 控制请求分发，不是路由定义本身
urls.py 的本质是 URL 模式匹配表，它不处理业务逻辑，只决定“这个请求交给哪个视图”。主 urls.py（通常在项目根目录）负责一级分发，各 app 自己的 urls.py 负责二级细化。
常见错误现象：访问 /admin/ 报 404，大概率是主 urls.py 里漏了 path('admin/', admin.site.urls)；访问 /api/users/ 报 NoReverseMatch，常因 include() 时没传 namespace 或视图函数名拼错。
- 用
include()引入 app 的urls.py时，推荐加namespace参数，比如include('users.urls', namespace='users')，避免反向解析冲突 -
path()和re_path()不兼容参数：前者用<pk></pk>，后者得写正则(?P<pk>\d+)</pk>，混用会报TypeError: path() got an unexpected keyword argument 'name' - 调试时可临时在主
urls.py加print("URLs loaded")，确认它真被导入了（有时因 import 循环根本没执行）
wsgi.py 是 Web 服务器和 Django 的胶水层
wsgi.py 文件只在部署时起作用，本地 runserver 用的是 Django 自带的 WSGIHandler，不走这个文件。它本质是一个符合 WSGI 协议的 Python 可调用对象（application），供 Gunicorn、uWSGI 等调用。
常见错误现象：Gunicorn 启动报 ModuleNotFoundError: No module named 'myproject'，是因为 cd 到错目录或 --chdir 没设对；Nginx 返回 502，常因 wsgi.py 里 os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'myproject.settings') 的路径写错了。
-
os.environ.setdefault()必须在django.core.wsgi.get_wsgi_application()之前调用，顺序颠倒会触发ImproperlyConfigured - 生产环境别在
wsgi.py里写业务逻辑，比如数据库连接或缓存初始化——这些该放ready()信号或单独初始化模块里 - 如果用多 settings（如 staging/production），
wsgi.py中的DJANGO_SETTINGS_MODULE值必须和实际部署环境一致，不能依赖开发机上的 shell 环境变量
项目根目录下 manage.py 不是必须的，但删了就得手动补
manage.py 就是个带了 os.environ.setdefault('DJANGO_SETTINGS_MODULE', ...) 的脚本封装，它让命令行工具（runserver、migrate）知道该用哪套配置。没有它也能用 django-admin，但得每次都传 --settings。
容易被忽略的点：有些团队把 manage.py 改名或挪走，结果 CI 流水线跑 python manage.py test 直接失败；或者在 Dockerfile 里 COPY 错了路径，导致容器内找不到 manage.py。
-
manage.py开头的#!/usr/bin/env python在 Windows 上无效，但没关系——Windows 用户本来就不靠 shebang 启动 - 如果项目结构是
src/myproject/，那manage.py必须放在跟src同级，并在sys.path插入src目录，否则import myproject会失败 -
manage.py里的if __name__ == '__main__':块不能删，这是命令行入口的守门人
最麻烦的其实是路径和环境变量的耦合：settings.py 里写的 BASE_DIR / 'static'、wsgi.py 里依赖的 DJANGO_SETTINGS_MODULE、manage.py 里设定的 sys.path——三者稍有不一致，服务就起不来，而且错误提示往往不直接指向根源。
