Django模板中遍历含items键的字典时的冲突解决方法

以下是几种可行的解决办法，无需依赖自定义过滤器：

• 视图层预处理字典项
  在视图函数中直接将字典的items()结果提前计算好，传入模板上下文：

  # 视图代码
  def my_view(request):
      d = 解析JSON得到的字典
      context = {
          'd': d,
          'dict_items': d.items()  # 提前生成键值对迭代器
      }
      return render(request, 'my_template.html', context)
  

  模板中直接遍历预处理好的对象：

  {% for k, v in dict_items %}
      {# 处理逻辑 #}
  {% endfor %}
  

  这种方式完全避开模板中的语法冲突，性能也最优，因为预处理只在视图层执行一次。

• 重命名字典中的冲突键
  如果业务逻辑允许，直接修改JSON解析后的字典，将items键重命名为其他名称（比如item_list）：

  # 视图代码
  d = 解析JSON得到的字典
  if 'items' in d:
      d['item_list'] = d.pop('items')
  

  模板中正常遍历d.items即可，不会再触发键值查找。

• 使用自定义模板标签获取字典项
  编写一个简单的模板标签，直接返回字典的items()结果：

  # templatetags/custom_tags.py
  from django import template
  
  register = template.Library()
  
  @register.simple_tag
  def dict_items(d):
      return d.items()
  

  模板中先加载标签库，再获取并遍历：

  {% load custom_tags %}
  {% dict_items d as dict_items %}
  {% for k, v in dict_items %}
      {# 处理逻辑 #}
  {% endfor %}
  

• 包装字典以调整属性查找优先级
  创建一个简单的字典包装类，让模板优先调用items方法而非查找items键：

  # 视图代码中定义或导入包装类
  class MethodPrioritizedDict:
      def __init__(self, data):
          self.data = data
  
      def items(self):
          return self.data.items()
  
      def __getitem__(self, key):
          # 当key为'items'时主动抛出KeyError，让模板转而调用getattr
          if key == 'items':
              raise KeyError
          return self.data[key]
  
      # 代理其他字典方法，保证模板中正常使用其他键
      def __getattr__(self, attr):
          return getattr(self.data, attr)
  
      def __contains__(self, key):
          return key in self.data
  

  视图中传入包装后的字典：

  context = {
      'd': MethodPrioritizedDict(解析JSON得到的字典)
  }
  

  模板中即可正常使用{% for k, v in d.items %}。

内容的提问来源于stack exchange，提问作者PlasmaHH