如何为Django Admin重写django-two-factor-auth模板？

我正在尝试为Django Admin重写django-two-factor-auth的模板，但不清楚操作方法。我的架构是Next.js前端+Django后端，没有使用Django自带的前端。

项目结构 #

django-project
 |-core
 |  |-settings.py
 |  └-urls.py
 |-my_app1
 |  |-models.py
 |  |-admin.py
 |  └-urls.py
 └-templates

已完成的配置步骤 #

• 安装依赖：pip install django-two-factor-auth[phonenumbers]
• 在core/settings.py中配置INSTALLED_APPS、MIDDLEWARE等项
• 在core/urls.py中添加相关路由
• 执行迁移：python manage.py migrate

当前登录页地址：http://localhost:8000/account/login/

问题与解答 #

1. 如何为Django Admin重写django-two-factor-auth的模板？ #

Django模板遵循「项目模板优先加载」的规则，只需按以下步骤操作：

• 定位目标模板路径：找到django-two-factor-auth包内的Admin相关模板，通常路径为templates/admin/two_factor/，包含login.html、verify_token.html等核心文件。
• 镜像路径创建文件：在项目根目录的templates文件夹下，创建与第三方模板完全一致的路径结构，比如要重写2FA登录模板，就创建templates/admin/two_factor/login.html。
• 自定义模板内容：复制原模板代码到新建文件中，按需修改样式、布局或逻辑，注意保留模板所需的变量和标签，保证功能正常运行。
• 确认加载优先级：在core/settings.py的INSTALLED_APPS中，确保你的项目应用（如core）排在django-two-factor-auth之前，让Django优先加载自定义模板。

2. 针对Django Admin的该模板有哪些推荐自定义方案？ #

• 统一Admin视觉风格：使用Django Admin原生CSS类（如module、form-row）改造2FA模板，让页面和Admin后台视觉统一。
• 简化验证选项：如果Admin用户主要使用TOTP验证，可隐藏短信等其他验证方式，减少页面复杂度。
• 添加场景化提示：在验证页面补充针对性引导文字，比如「请输入Google Authenticator中的6位验证码」，降低用户操作成本。
• 优化错误提示：重写模板中的错误信息，替换通用提示为更贴合Admin场景的内容，比如「验证码无效，请重新输入」。
• 适配响应式布局：确保自定义模板在移动端正常显示，和Django Admin的响应式设计保持一致。
• 植入品牌元素：按需添加项目logo或品牌色，强化视觉识别度。

内容的提问来源于stack exchange，提问作者Super Kai - Kazuya Ito