如何在Django admin后台的textarea组件中保留输入的空行？

问题排查第一步：确认空行丢失的阶段 #

首先需要确认空行是在存储到数据库时丢失，还是仅在Admin列表页展示时丢失：

• 保存内容后，点击对应记录的编辑按钮进入编辑页，查看textarea中是否还存在之前输入的空行：
  • 如果编辑页空行还存在：属于展示阶段的渲染问题，参考方案1
  • 如果编辑页空行已经消失：属于存储阶段的字段处理问题，参考方案2

方案1：修复Admin列表页展示时的空行丢失问题 #

HTML默认会将连续的空白字符（换行、空格、制表符）合并为单个空格，所以即使数据库中存了空行，直接在list_display中输出字段内容也不会显示换行。你可以自定义列表展示方法，将换行符转换为HTML换行标签：

from django.utils.html import linebreaks, escape
from django.contrib import admin
from .models import MyObject

class MyObjectAdmin(admin.ModelAdmin):
    # 替换原来的some_text为自定义渲染方法
    list_display = ('id', 'formatted_some_text')

    def formatted_some_text(self, obj):
        # 先转义特殊字符避免XSS风险，再把换行转为<br>标签
        return linebreaks(escape(obj.some_text))
    # 配置列表表头显示名称
    formatted_some_text.short_description = "文本内容"

    # 保留你原来的textarea配置
    def formfield_for_dbfield(self, db_field, **kwargs):
        formfield = super().formfield_for_dbfield(db_field, **kwargs)
        if db_field.name == 'some_text':
            formfield.widget = forms.Textarea(attrs={'rows': 10, 'cols': 80})
        return formfield

方案2：修复存储阶段的空行丢失问题 #

如果编辑页中已经看不到之前输入的空行，说明数据在提交保存时就被处理掉了，可按以下步骤调整：

1. 修正模型字段的异常写法
   你给出的模型代码中some_text = prompt = db.CharField(max_length=10000)属于多变量指向同个字段的异常写法，同时针对大段带换行的文本更建议使用TextField，不需要受CharField的长度逻辑限制，建议改为标准写法：

from django.db import models

class MyObject(models.Model):
    some_text = models.TextField(max_length=10000)

2. 关闭表单字段的默认空白修剪逻辑
   Django的CharField/TextField对应的表单字段默认开启了strip=True配置，会自动移除字段内容首尾的空白字符，也可能导致首尾的空行丢失。你可以在自定义表单字段的逻辑中关闭该配置：

def formfield_for_dbfield(self, db_field, **kwargs):
    formfield = super().formfield_for_dbfield(db_field, **kwargs)
    if db_field.name == 'some_text':
        formfield.widget = forms.Textarea(attrs={'rows': 10, 'cols': 80})
        # 关闭首尾空白修剪逻辑，保留首尾空行
        formfield.strip = False
    return formfield

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