不能靠upload自身配置实现上传前自动裁剪，必须用croppers模块替代原生upload并在choose阶段介入裁剪逻辑；accept:'images'仅限制文件类型，不触发裁剪，auto:true会立即上传原始文件，裁剪需在choose回调中通过auto:false拦截并处理。
不能靠 upload 自身配置实现上传前自动裁剪，必须用 croppers 模块替代原生 upload，并在 choose 阶段介入裁剪逻辑。
为什么 upload.render() 加 accept: 'images' 不起作用
Layui 原生 upload 组件只负责文件选择和提交，不处理图像预览、裁剪、格式转换等前端加工。设置 accept: 'images' 仅限制文件类型，不会触发任何裁剪行为；auto: true（默认）会立即上传原始文件，根本没机会裁剪。
- 常见错误：把
cropper初始化写在done或before回调里 → 此时文件已发出或正在发送，裁剪无效 - 真正可操作的窗口期只有
choose回调：用户选中文件后、点击“确定”上传前 - 必须设
auto: false，否则choose回调拿到的是空obj.files
croppers.render() 的关键参数怎么填
croppers 是社区封装的 layui 模块（非官方），它把 FileReader、canvas 渲染、裁剪控制、上传触发全包了，但参数名和语义容易误解。
-
elem必须是容器元素（如<div id="crop-box"></div>），不是按钮 —— 否则 canvas 无法挂载，报Cannot read property 'cropper' of undefined -
mark控制裁剪框比例，mark: 1/1表示正方形，mark: 4/3表示 4:3，设为false则自由拖拽无约束 -
saveW/saveH是最终输出图片的宽高（单位 px），不是裁剪框大小；实际裁剪区域由mark+ 用户拖拽决定 -
url填后端接收接口地址（如/upload/avatar），不是图片 URL；它会被croppers内部用FormData提交
如何强制输出 JPEG 并控制压缩质量
croppers 默认调用 toDataURL('image/png')，上传体积大、不兼容部分后端解析。需手动覆盖 canvas 导出逻辑。
- 在
croppers.render()的done前无法干预，得改源码或监听内部事件 —— 更稳妥做法是：不用croppers，自己用cropper.js+upload.render({ auto: false })手动控制 - 若坚持用
croppers，可在其回调外加一层拦截：监听croppers触发的上传前事件（部分版本支持before），或 monkey patchcroppers.upload方法 - 最简方案：在后端接收时统一转 JPEG，前端只传 base64 或 Blob，由服务端 decode 后重编码（避免前端 canvas 兼容性问题）
裁剪不是配置开关，而是 DOM 生命周期里的一个精确时机控制 —— 容器是否存在、choose 是否被正确拦截、FileReader 是否完成加载，三者缺一不可。最容易漏掉的是 elem 对应的 DOM 节点未渲染完成就调用 croppers.render()，导致整个流程静默失败。
