0

0

如何在 Django Admin 中为外键字段添加可点击的链接

霞舞

霞舞

发布时间:2026-01-19 10:12:02

|

190人浏览过

|

来源于php中文网

原创

如何在 Django Admin 中为外键字段添加可点击的链接

django admin 默认不为 `foreignkey` 字段生成跳转链接,但可通过自定义 `list_display` 方法结合 `reverse()` 和 `format_html()` 实现——让列表页中的用户名称变为指向对应 `useradmin` 页面的超链接,并支持排序与查询优化。

在 Django Admin 中,将外键对象(如 user)直接显示在 list_display 中时,默认仅渲染其 __str__() 结果(例如用户名),且不带链接。若希望点击该字段即可跳转至对应对象的编辑页(如 CustomUser 的 admin 编辑界面),需手动构造带 URL 的 HTML 输出。

✅ 正确实现方式

首先,导入必要模块,并在 ModelAdmin 中定义一个带装饰器的方法:

from django.contrib import admin
from django.urls import reverse
from django.utils.html import format_html
from django.contrib.admin import display

@admin.register(MyLog)
class MyLogAdmin(admin.ModelAdmin):
    list_display = ['id', 'username_link']
    list_select_related = ['user']  # ⚡ 关键优化:避免 N+1 查询

    @display(ordering='user__username', description='User')
    def username_link(self, obj):
        if not obj.user:
            return '-'
        return format_html(
            '{}',
            reverse('admin:myapp_customuser_change', args=[obj.user.pk]),
            obj.user.username or str(obj.user)
        )
? 注意替换 myapp:'admin:myapp_customuser_change' 中的 myapp 必须是定义 CustomUser 模型所在 Django 应用的 app_label(即 apps.py 中 AppConfig.label 或 INSTALLED_APPS 中注册的 app 名),而非 MyLog 所在应用。可通过 CustomUser._meta.app_label 动态获取(见进阶写法)。

? 进阶建议:提升健壮性与可维护性

  • 动态获取 app_label(推荐)
    避免硬编码,适配自定义用户模型:

    from myapp.models import CustomUser  # 替换为你的 CustomUser 所在模块
    
    app_label = CustomUser._meta.app_label
    model_name = CustomUser._meta.model_name
    url = reverse(f'admin:{app_label}_{model_name}_change', args=[obj.user.pk])
  • 兼容 AUTH_USER_MODEL(最佳实践)
    若项目使用 settings.AUTH_USER_MODEL 自定义用户模型,应统一通过 get_user_model() 获取:

    from django.contrib.auth import get_user_model
    User = get_user_model()
    app_label = User._meta.app_label
    model_name = User._meta.model_name
  • 空值安全处理
    外键允许为空(null=True)时,务必检查 obj.user 是否存在,否则会触发 AttributeError。

  • 启用 list_select_related
    如上例中 list_select_related = ['user'] 可确保在列表页一次查询中预取关联的 user 数据,显著提升性能,尤其在数据量大时。

✅ 效果验证

配置完成后,在 /admin/myapp/mylog/ 列表页中:

Ai Mailer
Ai Mailer

使用Ai Mailer轻松制作电子邮件

下载
  • “User” 列标题可点击排序(按 user__username 升序/降序);
  • 用户名文本变为蓝色可点击链接,点击后跳转至 /admin/myapp/customuser/123/change/;
  • 后台 SQL 查询数减少,无额外 SELECT 抓取用户信息。

此方案无需第三方包,完全基于 Django 内置机制,简洁、高效、符合官方推荐模式。

相关专题

更多
数据分析工具有哪些
数据分析工具有哪些

数据分析工具有Excel、SQL、Python、R、Tableau、Power BI、SAS、SPSS和MATLAB等。详细介绍:1、Excel,具有强大的计算和数据处理功能;2、SQL,可以进行数据查询、过滤、排序、聚合等操作;3、Python,拥有丰富的数据分析库;4、R,拥有丰富的统计分析库和图形库;5、Tableau,提供了直观易用的用户界面等等。

683

2023.10.12

SQL中distinct的用法
SQL中distinct的用法

SQL中distinct的语法是“SELECT DISTINCT column1, column2,...,FROM table_name;”。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

320

2023.10.27

SQL中months_between使用方法
SQL中months_between使用方法

在SQL中,MONTHS_BETWEEN 是一个常见的函数,用于计算两个日期之间的月份差。想了解更多SQL的相关内容,可以阅读本专题下面的文章。

347

2024.02.23

SQL出现5120错误解决方法
SQL出现5120错误解决方法

SQL Server错误5120是由于没有足够的权限来访问或操作指定的数据库或文件引起的。想了解更多sql错误的相关内容,可以阅读本专题下面的文章。

1095

2024.03.06

sql procedure语法错误解决方法
sql procedure语法错误解决方法

sql procedure语法错误解决办法:1、仔细检查错误消息;2、检查语法规则;3、检查括号和引号;4、检查变量和参数;5、检查关键字和函数;6、逐步调试;7、参考文档和示例。想了解更多语法错误的相关内容,可以阅读本专题下面的文章。

357

2024.03.06

oracle数据库运行sql方法
oracle数据库运行sql方法

运行sql步骤包括:打开sql plus工具并连接到数据库。在提示符下输入sql语句。按enter键运行该语句。查看结果,错误消息或退出sql plus。想了解更多oracle数据库的相关内容,可以阅读本专题下面的文章。

676

2024.04.07

sql中where的含义
sql中where的含义

sql中where子句用于从表中过滤数据,它基于指定条件选择特定的行。想了解更多where的相关内容,可以阅读本专题下面的文章。

575

2024.04.29

sql中删除表的语句是什么
sql中删除表的语句是什么

sql中用于删除表的语句是drop table。语法为drop table table_name;该语句将永久删除指定表的表和数据。想了解更多sql的相关内容,可以阅读本专题下面的文章。

417

2024.04.29

PHP WebSocket 实时通信开发
PHP WebSocket 实时通信开发

本专题系统讲解 PHP 在实时通信与长连接场景中的应用实践,涵盖 WebSocket 协议原理、服务端连接管理、消息推送机制、心跳检测、断线重连以及与前端的实时交互实现。通过聊天系统、实时通知等案例,帮助开发者掌握 使用 PHP 构建实时通信与推送服务的完整开发流程,适用于即时消息与高互动性应用场景。

11

2026.01.19

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Bootstrap 5教程
Bootstrap 5教程

共46课时 | 2.9万人学习

AngularJS教程
AngularJS教程

共24课时 | 2.7万人学习

CSS教程
CSS教程

共754课时 | 20.8万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号