最简单可靠的方式是在数据中为每个需展开节点显式设置spread: true；该字段为节点级布尔配置，只作用于当前节点且不继承，必须逐层为children中每个对象添加，不可依赖全局开关或dom操作。

直接在数据里给每个节点加 spread: true，是最简单、最可靠的方式。layui tree 从 v2.5.0 起原生支持该字段，渲染时自动识别，无需额外调用方法或操作 dom。

为什么 spread: true 必须逐层写进每个节点

spread 是节点级布尔配置，只影响当前节点本身，不继承、不传播。父节点设了 spread: true，子节点仍默认收起——除非子节点自己也显式写了 spread: true。

• 常见错误：只给一级节点加 spread: true，结果只有第一层展开，二级以下全收着
• 漏写 spread 字段等价于 spread: false，不是“默认展开”
• 若节点没有 children 数组（即叶子节点），spread 字段会被忽略，加了也无效
• spread 必须是布尔值 true 或 false，写成 "true" 或 1 会失效

后端返回的数据没 spread 怎么办

大多数后端接口不会返回 spread 字段，需要前端预处理。推荐用递归函数深拷贝并打标，避免污染原始数据。

深蓝色网站后台管理系统layui框架模板-AdminPro

一款深蓝色网站后台管理系统layui框架模板

下载

• 用 JSON.parse(JSON.stringify(data)) 深拷贝原始数据（注意：如果原始数据含 getter/setter 或 Symbol，需改用结构化克隆）
• 写一个递归函数，对每个含 children 的节点都设 spread: true，叶子节点跳过
• 若节点有 disabled: true，即使设了 spread: true 也不会展开（Layui 隐式行为）
• 别用 tree.getData() 取数据再加工——它返回的可能是浅拷贝或结构不完整，应始终基于你传入的原始 data 数组操作

accordion 模式下默认展开多个节点失效怎么办

开启 accordion: true 后，同级节点只能有一个展开。即使你在数据里给多个兄弟节点都写了 spread: true，渲染时也只有第一个生效，其余被强制收起。

• 这是手风琴模式的设计逻辑，不是 bug
• 如需所有节点默认展开，请关闭 accordion（即不传该参数，或显式设为 false）
• onlyIconControl: true 不影响默认展开，但会影响用户后续点击行为——此时只能点小箭头图标触发展开/折叠，点文字标题无反应
• 调试时优先确认这两个配置是否开启，再排查 spread 是否写对位置和类型

真正容易被忽略的是：spread 字段必须存在于你调用 tree.render() 时传入的那个原始数据对象里，且不能被后续任何响应式代理（如 Vue 的 reactive）、深拷贝遗漏或后端字段映射覆盖掉。一旦数据结构动态生成，就得在 render 前确保每一层嵌套节点都已正确标记。