Django动态获取模型字段verbose_name并在HTML页面显示

脚本专家

在Django开发中，有时需要将模型的所有字段描述（verbose_name）及其对应的数据值动态展示在HTML页面上，并允许用户直接编辑。本文基于一个实际的环境配置模型Enviconfig，演示如何在后端遍历字段元数据，将verbose_name和字段值组装成字典，传递给模板渲染。

## 模型定义

假设有一个环境配置模型Enviconfig，定义在models.py中：

2. from django.db import models
4. class Enviconfig(models.Model):
5.     """环境模型类"""
6.     envname = models.CharField(max_length=100, verbose_name='环境名称')
7.     kafka_ip = models.CharField(max_length=100, verbose_name='Kafka Ip和端口')
8.     zookeeper_ip = models.CharField(max_length=100, verbose_name='Zookeeper IP和端口')
9.     mongo_ip = models.CharField(max_length=200, verbose_name='Mongo IP')
10.     mongo_port = models.CharField(max_length=200, verbose_name='Mongo端口号')
11.     redis_ip = models.CharField(max_length=211, verbose_name='Redis IP')
12.     redis_passwd = models.CharField(max_length=211, verbose_name='Redis密码')
13.     redis_db = models.CharField(max_length=211, verbose_name='Redis数据库名')
14.     prmc_nginx = models.CharField(max_length=211, verbose_name='Prmc_nginx')
15.     mysql_ip = models.CharField(max_length=211, verbose_name='Mysql IP')
16.     mysql_user = models.CharField(max_length=211, verbose_name='Mysql用户')
17.     mysql_passwd = models.CharField(max_length=211, verbose_name='Mysql密码')
18.     oracle_ip = models.CharField(max_length=211, verbose_name='Oracle IP')
19.     oracle_passwd = models.CharField(max_length=211, verbose_name='Oracle密码')
20.     oracle_user = models.CharField(max_length=211, verbose_name='Oracle用户')
22.     class Meta:
23.         db_table = 'enviconfig'
24.         verbose_name = '环境配置信息'
25.         verbose_name_plural = verbose_name
27.     def __str__(self):
28.         return "%s %s %s %s %s %s %s %s %s %s %s %s %s %s %s" % (
29.             self.envname, self.kafka_ip, self.zookeeper_ip, self.mongo_ip,
30.             self.mongo_port, self.redis_ip, self.redis_passwd, self.redis_db,
31.             self.prmc_nginx, self.mysql_ip, self.mysql_user, self.mysql_passwd,
32.             self.oracle_ip, self.oracle_passwd, self.oracle_user
33.         )

复制代码

注意：__str__方法将所有字段值以空格连接，这在后续拆分时依赖于字段值本身不含空格，否则会出错。更稳健的做法是直接通过字段名获取值，但本例沿用原始方式以展示原始思路。

## 视图实现：获取字段verbose_name与数据值

在视图的get方法中，先从Session获取用户昵称，然后查询envname为'lan'的记录，通过__str__()方法得到拼接字符串，再用split(' ')拆分为列表。同时通过apps.get_model获取模型类，遍历_meta.fields提取所有字段的verbose_name。注意第一个字段通常是主键（id），其verbose_name可能为默认值，这里用pop(0)跳过。然后将verbose_name列表与数据值列表按索引对齐，构建字典dict1，最终传递给模板。

2. from django.apps import apps
4. def get(self, request):
5.     """处理GET请求，返回页面"""
6.     nick = request.session.get('nick')
7.     qs = Enviconfig.objects.filter(envname='lan')
8.     lan = qs[0].__str__()
9.     env = lan.split(" ")
11.     modelobj = apps.get_model('ywjenkins', 'Enviconfig')
12.     field_list = []
13.     for field in modelobj._meta.fields:
14.         field_list.append(field.verbose_name)
15.     field_list.pop(0)  # 移除第一个字段（通常是id）的verbose_name
17.     dict1 = {}
18.     for x in field_list:
19.         dict1[x] = env[field_list.index(x)]
21.     return render(request, 'jenkins/jenkinsconfig.html', {
22.         'nick': nick,
23.         'dict': dict1
24.     })

复制代码

## 模板展示效果

在HTML模板中，可以遍历dict字典，显示每个字段的verbose_name作为描述，以及对应的数据值（直接显示或放在input标签中供修改）。原文中提到的“第三列是input标签”可以在模板中用类似< input value="{{ value }}" >实现，具体取决于模板设计。这里不展开。

## 注意事项与优化建议

1. 字段值包含空格的隐患：如果某个字段值本身包含空格（如IP地址一般无空格，但某些备注字段可能含空格），split(" ")会导致列表长度与字段数不匹配，进而索引错位。建议改用直接通过模型实例的字段名获取值，例如：

2. for field in modelobj._meta.fields:
3.     if field.name != 'id':
4.         dict1[field.verbose_name] = getattr(qs[0], field.name)

复制代码

这样更可靠。

2. 动态展示所有字段的适用场景：适合配置管理页面、动态表单等，无需为每个字段单独写模板变量。

3. 代码中的硬编码：modelobj = apps.get_model('ywjenkins', 'Enviconfig')中的'app_label'需要与实际应用名一致，否则会报错。

## 总结

本文通过一个具体模型Enviconfig演示了在Django视图中如何利用_meta.fields获取字段verbose_name，并结合模型实例的__str__()方法（或直接getattr）提取数据值，最终以字典形式传递给模板，实现字段描述与值的动态展示。这种模式在需要灵活展示模型配置的场景中非常实用。

热心网友1

你分享的这个方法很实用，能动态展示模型字段的 verbose_name 和数据值，方便前端展示和编辑。不过我注意到几个小细节，想跟你探讨一下： 1. **`split(' ')` 的隐患**：如果某个字段值本身就包含空格（比如“192.168.1.1:9092”没问题，但万一有描述性文字），拆分后列表长度会错位。更稳妥的方式是直接通过字段名获取值，比如用 `getattr(qs[0], field.name)`，这样既安全又不需要依赖 `__str__`。 2. **构建字典的代码**：最后那行 `dict1 = env[field_list.index(x)]` 似乎每次循环都把 `dict1` 赋值为单个值，而不是累积。应该是 `dict1 = env[field_list.index(x)]` 或者用 `zip(field_list, env)` 直接生成字典。 3. **跳过 id 字段**：`pop(0)` 假设 id 是第一个字段，但最好显式判断 `field.name != 'id'` 或者用 `field.primary_key` 过滤，更通用。 整体思路很棒，适合快速搭建配置管理页面。期待你优化后的完整版本！

热心网友1

感谢分享，这个思路很实用，把模型字段的 verbose_name 动态提取出来展示在页面上，能减少模板里的硬编码。 不过注意代码里有个小问题：`dict1 = env[field_list.index(x)]` 这一行会把 `dict1` 赋值为单个值，而不是构建 `{verbose_name: value}` 的字典。可以改成 `dict1 = env[field_list.index(x)]`，或者直接用 `zip` 更简洁： ```python dict1 = dict(zip(field_list, env)) ``` 另外，依赖 `__str__` 并用空格拆分的方式比较脆弱——如果某个字段值本身包含空格就会错位。建议直接通过字段名取值，例如在拿到模型实例 `qs[0]` 后，用 `getattr(obj, field.name)` 获取值，这样更稳定，也省去了拆分步骤。整体方法很实用，感谢分享！

热心网友1

你的思路很清晰，通过 `_meta.fields` 和 `verbose_name` 动态生成页面标签是个常见的实用技巧。不过我看到 `dict1` 的赋值循环里 `dict1 = env[field_list.index(x)]` 这行会把字典覆盖成单个值，应该是 `dict1 = env[field_list.index(x)]` 才对吧？另外用 `split(" ")` 拆分 `__str__` 的结果确实依赖字段值不含空格，如果后面字段值里可能出现空格，建议直接用 `getattr(qs[0], field.name)` 来取值，更安全。整体思路很棒，感谢分享！