新手指南：Django 模板為什麼不能多重繼承？
更新日期： 2024 年 12 月 19 日
本文為 Django 一鍵切換使用者身分教學，第 5 篇：
- Django 如何設計一鍵切換使用者角色的模型
- Django 用者角色管理與路徑設計
- 動態角色管理：設計簡潔統一的 /users/ 路徑
- 新手指南：如何設計接案者與發包者的 django 頁面模板
- 新手指南：Django 模板為什麼不能多重繼承？ 👈 所在位置
Django 的模板繼承系統是一種強大且直觀的工具，用於構建可重用的網頁結構。
但對於新手來說，一個常見的問題是：為什麼模板不能同時繼承多個基底模板？
本文將解釋這一設計背後的原因，並提供幾種靈活實現「多重繼承效果」的替代方案。
為什麼 Django 模板不能多重繼承？
繼承鏈的唯一性
Django 的模板系統基於單一繼承鏈進行設計，即一個模板只能從一個基底模板繼承。
這樣的設計避免了多重繼承可能引發的混亂，例如：
- 區塊覆寫優先權：如果兩個基底模板都定義了
{% block content %}，子模板應該覆寫哪一個？ - 結構歧義：當多個基底模板的結構不同時，如何將它們無縫整合？
保持設計簡化
單一繼承鏈讓模板層次更加清晰：
- 基底模板負責定義頁面的框架結構。
- 子模板負責擴展和覆寫具體的區塊內容。
這種設計降低了開發者理解和維護的成本。
如何實現類似多重繼承的效果？
雖然 Django 不支持直接多重繼承，但我們可以通過以下策略靈活模擬多重繼承的效果。
基底模板分區塊組合
將多個基底模板的結構抽取到一個更高層級的主基底模板，並分區塊管理。
主基底模板：base.html
<!DOCTYPE html>
<html lang="en">
<head>
<title>{% block title %}網站標題{% endblock %}</title>
</head>
<body>
<header>
{% include "shared/header.html" %}
</header>
<main>
{% block content %}{% endblock %}
</main>
<footer>
{% include "shared/footer.html" %}
</footer>
</body>
</html>
子模板：dashboard.html
{% extends "base.html" %}
{% block content %}
<section>
<h1>儀表板內容</h1>
</section>
{% endblock %}
這種方法通過將共用部分提取到區塊，實現了靈活的結構組合。
使用 {% include %} 插入部分內容
當模板需要組合不同功能模塊時，可以用 {% include %} 來插入模板片段，例如導航欄、側邊欄等。
基底模板：base.html
<!DOCTYPE html>
<html>
<head>
<title>{% block title %}標題{% endblock %}</title>
</head>
<body>
{% include "shared/sidebar.html" %}
<main>
{% block content %}{% endblock %}
</main>
</body>
</html>
子模板：dashboard.html
{% extends "base.html" %}
{% block content %}
<h2>主要內容</h2>
<p>這是儀表板的主要內容。</p>
{% endblock %}
插入模板片段：shared/sidebar.html
<aside>
<ul>
<li><a href="#">首頁</a></li>
<li><a href="#">設定</a></li>
</ul>
</aside>
使用 {% include %} 能夠靈活地重複利用模板片段，適合處理獨立的小模塊。
多層模板繼承
如果需求較為複雜，可以將通用結構放在一個主基底模板中，再通過中間層基底模板進行細化。
通用基底模板：base.html
<!DOCTYPE html>
<html lang="en">
<head>
<title>{% block title %}通用標題{% endblock %}</title>
</head>
<body>
<header>{% block header %}通用頭部{% endblock %}</header>
{% block content %}{% endblock %}
<footer>{% block footer %}通用頁尾{% endblock %}</footer>
</body>
</html>
中間層模板：dashboard_base.html
{% extends "base.html" %}
{% block header %}
<h1>儀表板專用頭部</h1>
{% endblock %}
{% block content %}
<aside>側邊欄內容</aside>
<div>{% block main_content %}{% endblock %}</div>
{% endblock %}
最終頁面模板：dashboard.html
{% extends "dashboard_base.html" %}
{% block main_content %}
<h2>專案列表</h2>
<ul>
<li>專案 1</li>
<li>專案 2</li>
</ul>
{% endblock %}
這種多層模板繼承方式適合功能層級分明的頁面設計。
模板結構的實踐建議
避免過度繼承
盡量保持模板繼承鏈簡潔，過多的繼承層級會增加代碼的維護難度。
抽取共用部分
將多個模板中重複使用的結構或功能，抽取到共享模板片段（如 {% include %}）中。
分層設計
在需要擴展時，考慮引入中間層模板，分離通用結構與具體功能。
總結
雖然 Django 模板系統不支持多重繼承，但透過分區塊組合、插入模板片段、以及多層模板繼承等方式，可以靈活實現多重繼承的效果，同時保持代碼清晰易維護。
這些方法不僅能幫助您解決設計需求，還能為未來的功能擴展做好準備。