uni-data-checkbox 多选绑定要求 v-model 必须为数组，初始化需设为 []；localdata 中每个对象须含 value 和 text 字段，value 类型须与 v-model 数组元素一致；@change 中通过 e.detail.value 获取实时选中项，统计等逻辑应在此处理。
uni-data-checkbox 多选绑定和 v-model 类型必须匹配
多选状态下 v-model 必须是数组，不是字符串或 null。常见错误是初始化写成 value: '' 或 value: null，导致组件无法渲染勾选状态，控制台也无报错。
正确做法是显式初始化为空数组：
-
data()中定义value: [] - 如果默认要预选中，填入对应
value字段组成的数组，如[0, 2] - 后端返回的选项数据（
localdata）里每个对象必须含value和text字段，且value类型需与v-model数组元素类型一致（推荐用 number 或 string，避免混用）
实时统计逻辑要放在 @change 回调里，别依赖 computed
@change 触发时，e.detail.value 就是当前选中的数组，这是唯一可靠的数据源。不要试图在 computed 里监听 v-model 变量做统计——uni-app 的响应式在多选组件中有时滞后，尤其配合 min/max 限制时。
示例：统计已选数量、计算价格总和、禁用提交按钮：
- 直接在
methods.change里处理：this.selectedCount = e.detail.value.length - 若需映射原始数据（比如显示选中项的
text），用localdata.filter(item => e.detail.value.includes(item.value)) - 避免在 change 里执行耗时操作（如频繁请求），可加防抖（
setTimeout或节流函数）
排版复杂时用 flex + uni-grid 替代手写 view 布局
纯 view 嵌套容易错行、换行不一致，尤其在 iOS 和小程序端表现差异大。官方 uni-grid 组件对齐稳定，且支持响应式列数（column 属性）。
关键点：
- 把
uni-data-checkbox放进uni-grid-item，而非直接平铺view - 设置
column="3"（三列）或根据屏幕宽度动态计算：:column="getColNum()" - 禁用默认边距：给
uni-grid加class="no-border"并在样式里重置padding和margin - 文字过长时，用
text-overflow: ellipsis截断，别靠white-space: nowrap强制单行——会撑破容器
min/max 限制下取消选中失效？检查 localdata 是否含 disable 字段
当设置了 min="1" 且只选了一项，再点击该项时不会取消——这是预期行为。但若发现“明明没到 min 却无法取消”，大概率是某条 localdata 数据里误加了 disable: true。
注意：disable 是数据字段，不是组件属性。写在 localdata 里才生效：
- ✅ 正确：
{"value": 0, "text": "篮球", "disable": true} - ❌ 错误：
<uni-data-checkbox :disable="true" ...></uni-data-checkbox>—— 这个属性不存在，会被忽略 - 调试技巧：打印
localdata到 console，肉眼确认是否有意外的disable字段
复杂表单里最易被忽略的是 v-model 类型与 localdata.value 类型的隐式转换——比如后端返回字符串 "1"，你却用数字 1 去比对，导致预选中失败。动手前先 console.log 看一眼原始数据类型。
