从新手到高手：精研Django Settings秘籍

原文作者 ：我辈理想
版权声明 ：文章原创，转载时请务必加上 、作者信息和本声明。

前言

Django框架是python的一个web框架，可以使用丰富的python的库。settings.py文件无论是本地开发还是环境部署都是经常使用的文件，如果settings没有配置好，开发将困难重重。很多时候环境代码正常，一个参数就能决定了你的成败。
偷偷告诉大家，我们平时习以为常的一个import 项目.settings，不是官方推荐的最佳方式。

一、settings基础配置

作为python语言，我们默认遵循 ，settings文件配置也是一样。

二、django默认配置

如果Django设置文件不需要定义任何设置。每个设置都有一个合理的默认值。这些默认值位于模块中 django/conf/global_settings.py。

三、django标准配置

django的全部配置可参考链接：
常用的标准配置包括邮箱配置、缓存配置、日志配置、session配置等

四、django第三方配置

1.使用三方配置

在实际开发过程中，我们会使用很多第三方配置，比如前后端分离项目,后端使用django+drf，drf的配置是一个常用的配置

django项目的settings文件
# drf配置  
REST_FRAMEWORK ={# 认证：微信认证"DEFAULT_AUTHENTICATION_CLASSES":['utils.jwt_auth.JWTAuthentication',# 自定义JWT认证# 'rest_framework_jwt.authentication.JSONWebTokenAuthentication','rest_framework.authentication.SessionAuthentication','rest_framework.authentication.BasicAuthentication',],'DEFAULT_PERMISSION_CLASSES':[# 'rest_framework.permissions.DjangoModelPermissionsOrAnonReadOnly']}

# jwt配置
JWT_AUTH ={# 过期时间'JWT_EXPIRATION_DELTA': datetime.timedelta(days=1),'JWT_AUTH_HEADER_PREFIX':'JWT',# 设置在请求头中的前缀，之前是通过请求体来做的，这里有所区别,默认为JWT# 'JWT_RESPONSE_PAYLOAD_HANDLER': 'user.utils.my_payload_response.jwt_response_payload_handler', # 重写返回字段}

# oracle数据库:服务端位置
Oracle_path = os.path.join(BASE_DIR,'utils','instantclient_21_6')

2.自建django三方库，如何使用配置

2.1自建settings文件

这个主要是在自己的三方库中建了一个setting文件，主要是from django.conf import settings和APISettings。DEFAULTS 是默认参数，如果django项目setting中没有设置FEISHU_V2_SDK_CONFIGS，建使用DEFAULTS 中的默认值。

#!/usr/bin/env python# -*- coding: utf-8 -*-import logging
from enum import Enum
from django.conf import settings
logger = logging.getLogger("feishu")# 环境变量名
DEFAULTS ={'FEISHU_TOKEN_EXPIRE_TIME':7200,# token时效, 'FEISHU_TOKEN_UPDATE_TIME':600,# token提前更新的时间'FEISHU_BATCH_SEND_SIZE':200,# 批量发送消息列表的大小限制'FEISHU_APP_ID':None,'FEISHU_APP_SECRET':None,'FEISHU_VERIFY_TOKEN':None,'FEISHU_ENCRYPT_KEY':None}classAPISettings:def__init__(self, defaults=None):
        self.defaults = defaults or DEFAULTS
        self.user_settings =getattr(settings,'FEISHU_V2_SDK_CONFIGS',None)# CKEditor 5 configuration in settingsdef__getattr__(self, attr):if attr notin self.defaults:raise AttributeError("Invalid API setting: '%s'"% attr)try:# Check if present in user settings
            val = self.user_settings[attr]except KeyError:# Fall back to defaults
            val = self.defaults[attr]# Cache the resultsetattr(self, attr, val)return val
api_settings = APISettings(DEFAULTS)# try:#     if settings.FEISHU_APP_ID:#         FEISHU_APP_ID = settings.FEISHU_APP_ID#     if settings.FEISHU_APP_SECRET:#         FEISHU_APP_SECRET = settings.FEISHU_APP_SECRET#     if settings.FEISHU_ENCRYPT_KEY:#         FEISHU_ENCRYPT_KEY = settings.FEISHU_ENCRYPT_KEY#     if settings.FEISHU_VERIFY_TOKEN:#         FEISHU_VERIFY_TOKEN = settings.FEISHU_VERIFY_TOKEN#     if settings.FEISHU_TOKEN_EXPIRE_TIME:#         FEISHU_TOKEN_EXPIRE_TIME = settings.FEISHU_TOKEN_EXPIRE_TIME#     if settings.FEISHU_TOKEN_UPDATE_TIME:#         FEISHU_TOKEN_UPDATE_TIME = settings.FEISHU_TOKEN_UPDATE_TIME#     if settings.FEISHU_BATCH_SEND_SIZE:#         FEISHU_BATCH_SEND_SIZE = settings.FEISHU_BATCH_SEND_SIZE# except Exception as e:#     logger.debug(f"导入飞书应用和事件的配置出现报错(%s)，请查看settings配置" % e)classAppType(str, Enum):
    TENANT ="tenant"# 企业自建应用
    USER ="user"# 第三方应用

2.2三方库中其他文件调用django项目settings

2.3三方库使用

这个可以参考上边的接口md文档。

五、参数详情

1.DEBUG管理

DEBUG配置虽然是一个布尔参数，但是在django配置起到至关重要的作用，很多参数都是跟DEBUG挂钩的。很多时候我们的参数未生效都是跟这个参数有关。比如ALLOWED_HOSTS、runserver命令、不同系统环境文件位置等。
一般的本地开发和测试环境DEBUG=True,线上环境DEBUG=False

2.静态配置

我这里主要举例常用的2中方式：本地开发、线上部署。
我们的静态文件通常都是在项目manage.py的同级目录下建立的static文件夹，或者项目app下的static文件夹。
在本地开发时，我们可能不需要使用命令收集静态文件。

STATIC_URL ='/static/'
STATICFILES_DIRS =[
    os.path.join(BASE_DIR,'static'),
    os.path.join(BASE_DIR,'app','static'),]

在部署线上时，通常静态文件和项目文件时分离的，就是静态文件和项目文件的权限不同，服务器的存储位置不同。静态文件通常用于nginx静态转发，django后端时端口转发。STATICFILES_DIRS记录所有静态文件的位置，collectstatic命令将STATICFILES_DIRS记录的静态文件收集到STATIC_ROOT文件下，用于nginx静态转发，linux系统部署时通常是/var/www/static/。

# 静态文件+媒体文件
STATIC_URL ='/static/'if DEBUG:
	STATICFILES_DIRS =[
	    os.path.join(BASE_DIR,'static'),
	    os.path.join(BASE_DIR,'app','static'),]else:
	STATICFILES_DIRS =[
	    os.path.join(BASE_DIR,'static'),
	    os.path.join(BASE_DIR,'app','static'),]# collectstatic命令将静态文件收集至STATIC_ROOT
    STATIC_ROOT ='/var/www/html/gstatic/'

注意：如果是在windows部署的前后端不分离项目，并且没有使用iis而是使用python manage.py runsever，通常会出现静态文件不显示的问题（收集静态文件也不起作用）

3.本地化国际化（翻译）

django开发中，常用的是本地化配置，主要是LANGUAGE_CODE 、TIME_ZONE、USE_L10N 和USE_TZ

LANGUAGE_CODE ='zh-Hans'
TIME_ZONE ='Asia/Shanghai'
USE_L10N =True
USE_TZ =False

在需要实现 的系统时，还需要在上述参数的基础上配置USE_I18N、LOCALE_PATHS 、LANGUAGES ，并且需要将要翻译的字符串添加标记（_(‘要翻译的内容’)），还需执行命令python manage.py makemessages -l en生成.po文件（交给翻译人员双语翻译），执行python manage.py compilemessages将.po文件转成.mo文件。

LOCALE_PATHS =(
    os.path.join(BASE_DIR,'language'),)
LANGUAGES =(('en','English'),('zh','中文简体'),)
LANGUAGE_CODE ='zh-Hans'
TIME_ZONE ='Asia/Shanghai'
USE_I18N =True
USE_L10N =True
USE_TZ =False

4.如有其他可在评论区回复

六、自定义配置名和正确导入settings配置

官方推荐的settings中的所有参数都是大写的，有考虑过为什么吗？我们在这里将官方的使用方式告诉大家，在后边的用到自定义配置参数时，可以少走弯路。

1.文件导入settings

# 官方推荐方式,是的就是这样，不是from 项目 import settingsfrom django.conf import settings

2.设置自定义参数

参数必须大写，如果包含小写将报错，AttributeError: ‘Settings’ object has no attribute ‘ALI_SEND_CODe’

# settings.py文件
AAA ='123'

3.程序中设置配置

# myapp_defaults 
BBB ='456'

# 程序veiws.pyfrom django.conf import settings
from app import myapp_defaults # 自定义的一些参数,这个是py文件 ifnot settings.configured:
    settings.configure(myapp_defaults, DEBUG=True)

3.读取settings配置

# from django.conf import settings
print(settings.AAA)print(settings.BBB)# 123# 456

七、settings配置文件拆分

在Django中，settings.py文件用于配置您的应用程序的设置。但是，随着应用程序变得越来越复杂，您可能会发现settings.py文件变得越来越大。这时，将其拆分成多个文件可以让代码更易于维护。

以下是将settings.py文件拆分为多个文件的步骤：

1. 创建一个名为settings的文件夹，用于存放所有的设置文件。
2. 将settings.py文件中的所有设置分成几个文件，例如：base.py、dev.py、prod.py、local.py等
3. 在base.py文件中将所有基本设置放置在一个文件中。例如：

# base.py
INSTALLED_APPS =['django.contrib.admin','django.contrib.auth','django.contrib.contenttypes','django.contrib.sessions','django.contrib.messages','django.contrib.staticfiles',]
DATABASES ={'default':{'ENGINE':'django.db.backends.sqlite3','NAME': BASE_DIR /'db.sqlite3',}}# 其他基本设置也可以放在这里

4. 在其他设置文件（如dev.py、prod.py、local.py等）中导入base.py文件中的所有设置，并进行必要的更改。例如：

# dev.pyfrom.base import*
DEBUG =True
ALLOWED_HOSTS =['localhost','127.0.0.1']

5. 最后，在您的应用程序中使用设置文件。例如，您可以在manage.py和wsgi.py文件中使用设置文件。
   manage.py 文件如下：

import os
import sys
defmain():"""Run administrative tasks."""if"develop"in sys.argv:
        sys.argv.remove("develop")
        os.environ.setdefault('DJANGO_SETTINGS_MODULE','webybt.settings.develop')else:
        os.environ.setdefault('DJANGO_SETTINGS_MODULE','webybt.settings.online')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()

wsgi.py文件如下

import os
from django.core.wsgi import get_wsgi_application
os.environ.setdefault('DJANGO_SETTINGS_MODULE','webybt.settings.online')
application = get_wsgi_application()

启动程序

我们时通过sys来获取命令中的参数，如果存在develop，我们就将配置指向develop.py。

1. pycharm启动
   

2. 命令行启动
   

八、问题处理

1.项目部署不显示静态文件

如果是在windows部署的前后端不分离项目，并且没有使用iis而是使用python manage.py runsever，通常会出现静态文件不显示的问题（收集静态文件也不起作用）

静态文件可以通过2中方式显示：一是将DEBUG设为True（一般线上部署都改成了False，不建议使用这种）；二是启动命令增加参数，正确的启动命令是python manage.py runsever --insecure。详见