Flask应用WTForms集成CKEditor时默认值不生效问题求解

直接给CKEditor绑定的表单项传value参数不生效，核心是两个问题：

1. textarea标签本身的默认值规则和普通input不同：普通input默认值取value属性，textarea的默认值是标签包裹的内部文本，你给textarea加value属性本身就不符合原生HTML规范，哪怕不用CKEditor都不会显示默认内容。
2. CKEditor初始化时会完全接管目标textarea的渲染逻辑，不会读取textarea上自定义的value属性，只会识别WTForms字段本身绑定的初始值，或者通过自身API传入的内容。
   另外你模板里还有两个笔误会影响功能：form.hidden_tag没加执行括号，submit按钮用了edit_loc_form变量，和前面渲染其他字段用的form变量名不统一。

方案1：表单实例预绑定数据（最规范，优先用） #

不要在模板渲染时给字段硬塞value参数，在视图函数实例化表单的时候，直接把数据库查到的记录对象传入表单的obj参数，WTForms会自动把对象中同名字段的值映射到表单项，Flask-CKEditor会自动读取这个值完成初始化填充，完全不用额外写前端逻辑。
视图层参考代码：

@app.route('/edit/<int:record_id>', methods=['GET', 'POST'])
def edit_record(record_id):
    # 查询要编辑的数据库记录
    target_obj = YourModel.query.get_or_404(record_id)
    # 实例化表单时传入obj参数，自动完成字段值映射
    form = YourForm(obj=target_obj)
    
    if form.validate_on_submit():
        # 提交时自动把表单数据写回数据库对象
        form.populate_obj(target_obj)
        db.session.commit()
        return redirect(url_for('your_list_page'))
    
    return render_template('edit.html', form=form, object=target_obj)

模板里删掉所有字段上手动加的value参数，修正笔误后的代码：

<form method="POST">
    {{ ckeditor.load() }}
    {{ form.hidden_tag() }}

    {{ form.name.label }}
    {{ form.name(class="form-control") }}

    {{ form.description.label }}
    {{ form.description(class="form-control") }}
    
    {{ form.submit(class="btn btn-primary") }}
</form>
{{ ckeditor.config(name='description') }}

如果你的表单类里description字段用的是Flask-CKEditor提供的CKEditorField，这套写法可以正常加载默认值。

方案2：前端手动调用CKEditor API赋值（适配特殊场景） #

如果你暂时不想调整视图层逻辑，可以在CKEditor初始化完成后，通过官方API手动塞入富文本内容，注意要等编辑器实例加载完成再执行，否则会报实例不存在的错误。
在模板中ckeditor.config()代码后追加以下脚本即可：

<script>
CKEDITOR.on('instanceReady', function (ev) {
    if (ev.editor.name === 'description') {
        // 用safe过滤器避免Jinja2转义HTML标签
        ev.editor.setData(`{{ object.description|safe }}`);
    }
})
</script>

• 检查表单类的description字段类型，必须是CKEditorField才能和CKEditor正确绑定，如果用了普通的TextAreaField，需要手动替换字段类型。
• 传入富文本内容时必须加Jinja2的|safe过滤器，不然富文本里的HTML标签会被转义成普通文本显示。
• 模板里的表单变量名必须统一，不要混着用form和edit_loc_form两个变量名，会导致字段渲染异常。

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