正确做法是纯函数式递归：rendermenu($nodes, $depth = 0) 必须返回本层li及子树html，不依赖外部变量；需终止条件清晰、子调用有返回值、标签严格闭合；输入须为children嵌套的树形结构，否则需先扁平转树。
直接结论：用纯函数式递归，每个调用只返回本层 li 及其子树 HTML，不依赖外部变量累积结果。 常见错误是把 $html 当全局拼接变量传参，导致子菜单重复渲染、层级错位、ul 嵌套断裂。
为什么不能把 $html 当参数反复拼接？
PHP 里字符串传参默认是值传递，但递归中若用 &$html 引用传参，多个分支会互相污染；若不用引用，子调用拼好的内容根本回不到父层。更糟的是，有人在循环里写 $html .= '<li>...</li>' 再递归调用，结果子树 HTML 被丢弃——因为没接收返回值。
- 正确做法：函数签名必须是
function renderMenu($nodes, $depth = 0)，返回字符串 - 每层只负责生成自己的
li标签，子树 HTML 由renderMenu($child['children'], $depth + 1)返回后手动拼入 - 绝对不要在函数体内初始化
$html = ''然后循环追加——它会覆盖上层传入的逻辑意图
renderMenu() 函数怎么写才不出错？
核心就三点：终止条件清晰、子树调用有返回、HTML 结构闭合严格。下面是最简健壮实现：
function renderMenu($nodes, $depth = 0) {
if (empty($nodes)) return '';
$html = '
- ';
foreach ($nodes as $node) {
$html .= '
- '; $html .= '' . htmlspecialchars($node['name']) . ''; if (!empty($node['children'])) { $html .= renderMenu($node['children'], $depth + 1); } $html .= ' '; } $html .= '
-
htmlspecialchars()必须包裹所有输出字段，防 XSS，不是可选优化 - 检查
!empty($node['children'])再递归，避免空数组触发无意义调用 - 不传
&$tree或&$html引用参数——这是绝大多数“菜单只显示第一层”的根源
数据必须是树形结构，不是扁平数组
如果你的原始数据是数据库查出的一维数组（带 pid 字段），renderMenu() 会直接失效——它只认 children 键存在且为数组。必须先做一次「扁平转树」：
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
- 用
foreach遍历原始数组，用id作键存入$map（如$map[$row['id']] = $row） - 再遍历一次，对每个节点找
$map[$row['pid']]，找到就 push 到其children数组里 - 根节点判断依据统一为
$row['pid'] == 0 || $row['pid'] === null，别混用''和0
这步漏掉，递归函数再完美也只渲染出顶层几个 li，子菜单永远为空。
深度超过 5 层时要注意 DOM 性能
HTML 嵌套本身不限深度，但浏览器 Layout 阶段对超深 DOM 敏感。实测超过 5 层 ul > li > ul > li > ... 会导致首屏延迟明显上升。
- 业务上真需要 6+ 层？优先考虑折叠交互（如点击展开），初始只渲染前 3 层
- PHP 层加
if ($depth >= 3) { return ''; }是最简单兜底，比前端 JS 折叠更可控 - 别用
str_repeat(' ', $depth * 2)做缩进——语义错乱且无法用 CSS 统一控制
真正难的从来不是写递归，而是确保输入数据结构可靠、输出 HTML 语义合规、深度边界有明确约束。这三个点任何一个松动，都会让菜单在某个用户那里突然消失或错位。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
