Django 项目从零配置：模板、静态文件与数据库

项目结构与静态资源配置

在使用 django-admin startproject 命令创建项目时，与 PyCharm 等 IDE 自动生成的项目不同，命令行方式不会自动创建 templates 和 static 文件夹。因此，开发者需要在项目根目录下手动建立这两个目录，并在 settings.py 中进行相应的路径配置。

模板目录 (Templates) 配置

为了让 Django 能够正确识别 HTML 模板文件，需要在 settings.py 的 TEMPLATES 配置项中指定目录路径。具体操作是将 DIRS 列表的值修改为根目录下的 templates 文件夹路径：

import os
TEMPLATES = [
    {
        # ... 其他配置 ...
        'DIRS': [os.path.join(BASE_DIR, 'templates')],
    },
]

静态文件 (Static Files) 配置

静态资源（如 CSS、JavaScript、图片）的管理同样需要手动配置。在 settings.py 中，除了默认的 STATIC_URL = '/static/' 外，还需要定义 STATICFILES_DIRS 列表，指向项目根目录下的 static 文件夹：

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

配置完成后，在 HTML 文件中引用静态资源时，必须使用 /static/ 作为前缀。例如：<link href="/static/style.css">。需要注意的是，STATIC_URL 变量名必须严格大写，且 HTML 中的引用路径必须与 settings.py 中的配置保持一致。如果修改了 STATIC_URL 的值，HTML 中的引用路径也需同步更新。

应用 (App) 的创建与注册

Django 项目通常由多个 App 组成。在命令行中创建名为 app01 的应用，需执行以下命令：

python3 manage.py startapp app01

创建完成后，必须将该 App 注册到项目中才能生效。打开 settings.py，找到 INSTALLED_APPS 列表，并添加如下配置：

INSTALLED_APPS = [
    # ... 其他应用 ...
    'app01.apps.App01Config',
]

推荐使用 app01.apps.App01Config 这种完整路径格式，这有助于 Django 更好地管理应用配置。

数据库配置：从 SQLite 到 MySQL

Django 默认使用 SQLite 数据库，但在实际生产或复杂开发中，通常需要使用 MySQL。切换数据库需要在 settings.py 的 DATABASES 配置中进行修改。

settings.py 数据库配置

在 DATABASES 字典中，将 ENGINE 设置为 MySQL 后端，并填入主机、端口、用户名、密码及数据库名称：

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'HOST': '127.0.0.1',
        'PORT': 3306,
        'USER': 'root',
        'PASSWORD': '',
        'NAME': 'dsb',
    }
}

PyMySQL 兼容性处理

由于 Django 底层依赖 MySQLdb，而 Python 3.x 版本对 MySQLdb 的支持存在兼容性问题，因此推荐使用 pymysql 作为替代驱动。需要在 App 的 __init__.py 文件中添加以下代码，将 pymysql 伪装成 MySQLdb：

import pymysql
pymysql.install_as_MySQLdb()

这一步骤解决了 Python 3 环境下 Django 连接 MySQL 的常见报错问题，确保数据库连接正常建立。

总结

完成上述配置后，Django 项目的基础环境即搭建完毕。开发者可以开始编写视图、模型和模板，并进行数据库迁移与测试。手动配置虽然比 IDE 自动生成繁琐，但能更清晰地理解 Django 的配置机制，便于后续维护与扩展。

以上就是 Django 初始配置（纯手写）的详细内容，更多关于 Django 开发、Python 后端配置的资料请关注本站其它相关文章！