Django 3.1：如何在模板中访问ModelChoiceField的对象属性

安全阿岳

2026-5-9

解决Django ModelChoiceField模板遍历访问模型属性的问题

这个问题我之前也碰到过，核心原因是你遍历form.available_spaces时拿到的不是直接的StorageSpace模型实例，而是Django表单字段生成的选项包装对象，所以直接访问.id、.price这些模型属性会失效。

正确的实现方式

你需要通过选项对象的.instance属性来获取对应的模型实例，然后就能访问所有模型字段了。同时别忘了给input设置正确的name属性，否则表单提交后无法正确绑定字段值。修改后的模板代码如下：

{% for space_option in form.available_spaces %}
  <label class="btn btn-outline-primary">
    <input 
      type="radio" 
      name="{{ form.available_spaces.name }}" 
      value="{{ space_option.instance.id }}" 
      data-storage-price="{{ space_option.instance.price }}"
      {% if space_option.is_selected %}checked{% endif %}
    >
    {{ space_option.instance.title }}
  </label>
{% endfor %}

关键细节解释

space_option.instance：这是获取对应StorageSpace实例的关键，通过它你可以访问模型的所有属性（id、price、title等）。
form.available_spaces.name：确保input的name和表单字段的name一致，这样Django才能正确处理提交的数据。
{% if space_option.is_selected %}checked{% endif %}：可选添加，用来保持表单的选中状态（比如编辑场景）。