layui的layedit需配合upload组件并配置uploadImage才能实现图片上传，否则插入图片会失败；必须设置uploadImage.url、type及success回调手动插入图片，且后端响应格式须严格为{code:0,msg:'',data:{src:'url'}}。
layui 的 layedit 文本域本身不直接处理图片上传，必须靠 upload 组件配合，并通过 uploadImage 配置项接管图片上传逻辑。否则点击「插入图片」按钮后会报错或静默失败。
layedit.build 里必须显式配置 uploadImage
很多人只调用 layedit.build('editor') 就以为能传图，结果点上传按钮没反应——根本原因是没告诉 layedit 用哪个接口、怎么处理响应。
-
uploadImage.url必须填真实后端地址，不能留空或写成'#' -
uploadImage.type推荐设为'post'（默认也是 post），避免某些后端因 method 不匹配拒绝请求 -
uploadImage.success回调里必须手动把返回的res.data.src插入编辑器，layedit 不自动做这事 - 如果后端返回格式不是 layedit 要求的
{code: 0, data: {src: 'xxx'}}，success里要自己解析并调用layedit.insertImage()
upload.render 和 layedit 共用时的常见冲突
当页面同时用了 upload.render（比如独立上传按钮）和 layedit 的图片上传，容易出现重复绑定、文件对象被 consume 一次后无法再读等问题。
- 不要给同一个
<input type="file">同时绑定upload.render和layedit—— layedit 内部已封装了 file input，外部 render 会干扰 - 若需额外上传入口（如封面图），用独立的
upload.render，但elem不能和 layedit 的容器重叠 -
before回调里别调obj.preview()再手动 append img，layedit 的图片插入逻辑和这个不兼容，会导致预览图错位或重复
后端返回格式必须严格匹配 layedit 要求
layedit 对上传响应极其敏感：字段名、code 值、嵌套层级错一个就插不进图片，控制台也不会报明显错误，只会卡在 loading 状态。
- 成功响应必须是：
{code: 0, msg: '', data: {src: 'https://xxx.jpg'}}（msg字段不能缺，哪怕为空字符串） -
data.src必须是可直接访问的完整 URL，不能是相对路径或后端内部路径（如e:\layui\image\abc.jpg） - 如果后端返回的是数组或带额外字段（如
{code: 0, url: 'xxx', filename: 'a.jpg'}），必须在uploadImage.success里手动转换：success: function(res) { layedit.insertImage(index, {src: res.url}); }
多图上传场景下 layedit 不支持批量插入
layedit 的图片上传设计是单次单图，即使你配置了 multiple: true，它也只取第一个文件。真要一次插多张，得放弃 layedit 自带上传，改用自定义按钮 + upload.render + 手动调用 layedit.insertImage()。
- 先用
upload.render({multiple: true})获取所有图片 URL - 循环调用
layedit.insertImage(editIndex, {src: url})，注意每次调用都要传当前编辑器实例 index - 别直接操作
textarea的 value 拼 HTML，layedit 内部 DOM 和 value 不实时同步，会导致光标错乱或内容丢失
最容易被忽略的是后端返回结构和前端 success 回调的衔接——看着上传成功了，图片就是不显示，大概率是 res.data.src 取错了或者 URL 不可达。建议先用 curl 或 Postman 模拟上传，确认返回体完全符合 layedit 文档要求，再联调前端。
