橡皮擦，一个逗趣的互联网高级网虫。新的系列，让我们一起进入 Django 世界。

十七、Django 配置之调试、文件上传、国际化

17.1 配置项之调试

学习 Django 配置一定要把两个文件打开，global_settings.py 与 settings.py，本篇文章第一个要学习的就是 DEBUG 配置项。

该配置项用于检测当前网站是否运行在测试环境，值可以选择 True 或者 False，当网站发布到服务器时，请注意关闭此项配置。

开启该配置最直观的感受就是，当出现错误的时候，会直接输出到网页上，也就是日常 Django 开发中看到的黄色屏幕。

该错误页面如果继续下拉，能查询到更多的配置信息。

如果 DEBUG 被开启之后，在 Django 中执行的 SQL 语句也会被记录下来。

DEBUG_PROPAGATE_EXCEPTIONS
如果将该值设置为 True，那当代码出现错误的时候，会直接提示如下内容。

A server error occurred. Please contact the administrator.

17.2 配置项之文件存储

**DEFAULT_FILE_STORAGE **
Django 默认使用的文件存储系统 django.core.files.storage.FileSystemStorage 是一个本地存储系统，相关配置在 global_settings.py 中，具体代码部分如下：

# Default file storage mechanism that holds media.
DEFAULT_FILE_STORAGE = 'django.core.files.storage.FileSystemStorage'

其余属性，都可以在配置文件中找到指定代码，不在进行罗列展示。

STATICFILES_STORAGE
django.contrib.staticfiles 提供了一个方便管理命令，用于将静态文件收集到一个目录中。

FILE_UPLOAD_HANDLERS
文件上传处理程序，修改之后可以对 Django 文件上传处理程序进行配置。

FILE_UPLOAD_MAX_MEMORY_SIZE
文件上传大小，默认为 2621440，配置中有说明，等于 2.5mb。

FILE_UPLOAD_PERMISSIONS
上传文件设置权限，默认为 0o600。

FILE_UPLOAD_TEMP_DIR
上传文件临时目录。

FILE_UPLOAD_DIRECTORY_PERMISSIONS
上传文件所在的文件夹权限设置。

MEDIA_ROOT
保存文件上传的绝对路径。

STATIC_ROOT
静态文件所在的文件夹。

STATICFILES_DIRS
除默认静态文件路径外，额外的静态文件路径，类型为列表。

17.3 国际化

本小节说明一些跟语言、数据相关的一些配置。

DECIMAL_SEPARATOR
十进制分隔符。

THOUSAND_SEPARATOR
千位分隔符。

FIRST_DAY_OF_WEEK
每周第一天的数字。

DATE_FORMAT
日期默认显示格式。

DATETIME_FORMAT
日期时间默认显示格式。

TIME_FORMAT
时间默认显示格式。

TIME_ZONE
UTC 时区设置。

LANGUAGE_CODE
APP 使用的语言设置，中文设置为 zh-Hans。

USE_I18N
是否启用翻译系统，启用之后 LANGUAGE_CODE 才会生效。

USE_L10N
是否启用本地化系统，启用之后，例如数字、日期、时间都会按照本地区格式进行展示。

17.4 再附赠一个

电子邮件
当配置好 DEBUG=True 之后，就可以设置 LOGGING 中的 AdminEmailHandler 即可实现当出现 BUG 的时候，发送给配置中的所有邮箱。

当然关于邮箱的配置，还有很多值要设置，例如 DEFAULT_FROM_EMAIL 默认邮件地址，EMAIL_BACKEND 邮件引擎，EMAIL_HOST 邮件服务器，EMAIL_HOST_USER 用户名，EMAIL_HOST_PASSWORD 登录密码，EMAIL_PORT SMTP 服务的端口号，EMAIL_TIMEOUT 邮件超时时间。

17.5 本篇博客小节

本篇博客继续带大家进入 Django 文件配置的学习，一起学习的可以点赞收藏走起来啦。

写在后面

本文章属于《滚雪球学 Python 第三轮》中的一篇，欢迎继续关注。

今天是持续写作的第 139 / 200 天。可以点赞、评论、收藏啦。