### Django 中配置应用在自身目录下查找模板文件的最佳实践 在 Django 项目中，默认情况下，Django 的 `TEMPLATES` 配置会指定全局的模板路径。然而，在大型项目或多应用结构中，为了提高模块化程度并减少耦合，推荐让每个应用在其自身的目录下维护独立的模板文件。 以下是实现这一目标的具体方法： #### 修改项目的 `TEMPLATES` 配置 在项目的 `settings.py` 文件中，找到 `TEMPLATES` 配置部分，并确保其 `DIRS` 参数为空或仅包含必要的全局模板路径。这样可以让 Django 默认优先从各个应用的子目录中加载模板文件[^1]。 ```python TEMPLATES = [ { 'BACKEND': 'django.template.backends.django.DjangoTemplates', 'DIRS': [], # 不在此处定义具体路径，允许 Django 自动扫描各应用下的 templates/ 'APP_DIRS': True, # 开启 APP_DIRS 让 Django 在每个应用的 templates/ 目录中自动寻找模板 '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', ], }, }, ] ``` #### 创建应用级别的模板目录 对于每一个 Django 应用（如 `myapp`），在该应用根目录下创建名为 `templates` 的子目录，并进一步按需组织模板文件。例如，如果某个应用有多个视图，则可以在 `templates/myapp/` 下分别存放对应的 HTML 文件[^2]。 假设有一个应用叫作 `blog`，它的模板文件应该按照如下方式组织： ``` blog/ ├── migrations/ ├── __init__.py ├── admin.py ├── apps.py ├── models.py ├── tests.py ├── views.py └── templates/ └── blog/ ├── index.html ├── detail.html └── archive.html ``` 这种命名约定不仅有助于保持清晰度，还能够防止不同应用之间的模板冲突。 #### 使用相对路径引用模板 当编写视图函数时，可以通过相对于应用名的方式引用模板文件。例如，针对上面提到的 `index.html` 文件，可以直接传递字符串 `'blog/index.html'` 给渲染器。 ```python from django.shortcuts import render def home(request): return render(request, 'blog/index.html') ``` 以上做法充分利用了 Django 提供的功能特性，既简化了跨团队协作过程中的复杂性，又增强了代码可读性和扩展能力。 ---