本文详解如何在 power bi 中使用 d3.js 构建可折叠树图时，避免因节点尺寸过大导致的重叠问题，核心在于正确配置树布局的 `size()` 和 `separation()` 参数，并适配矩形节点的实际高度。
在使用 D3.js（尤其是 v3 的 d3.layout.tree 或 v4+/v5+ 的 d3.tree）绘制层级结构图时，节点重叠是常见问题——尤其当每个节点被渲染为固定尺寸的
? 根本原因分析
你的节点是竖直方向堆叠的矩形（
var tree = d3.layout.tree()
.size([height, width]); // [yRange, xRange]但随后你手动覆盖了 y 坐标：
nodes.forEach(function(d) { d.y = d.depth * 180; }); // ⚠️ 强制设为每层间隔 180px这个 180 是硬编码值，而你的矩形高度是 80，上下留白不足（y: -40 到 +40 占满 80px），若兄弟节点垂直间距仅 180px，而树布局计算出的节点 y 值未预留足够间隙，就会发生视觉重叠——尤其在子节点较多或字体撑开时。
✅ 正确解法：让布局引擎“知道”节点真实尺寸
D3 v3 的 tree.size() 并不直接接受节点高度，但它控制的是节点中心点之间的最小垂直间距（在 d.depth 维度上）。因此，d.y 的步进值应 ≥ 节点总高度（含内边距）。你的矩形高 80px，建议最小行高 ≥ 100–120px 以保证安全间距。
✅ 推荐修改（D3 v3 兼容）：
// 替换原来的 tree.size([height, width])
var nodeHeight = 110; // 比矩形高（80）多留 30px 余量，防文字溢出/描边
var tree = d3.layout.tree()
.size([nodeHeight * (maxDepth + 1), width]); // 动态适配深度
// 同时移除手动 d.y 赋值！让 layout 自动计算
// ❌ 删除这一行：nodes.forEach(function(d) { d.y = d.depth * 180; });
// 确保 update() 中使用 layout 输出的 d.x/d.y
var nodes = tree.nodes(root).reverse();
// d.x → 垂直位置（决定矩形 y 坐标）
// d.y → 水平位置（决定矩形 x 坐标）然后在渲染节点时，将 d.x 作为矩形纵向中心（因 diagonal 投影已交换 x/y）：
nodeEnter.append("rect")
.attr("width", 150)
.attr("height", 80)
.attr("x", function(d) { return d.y - 75; }) // 水平居中：y 是水平坐标！
.attr("y", function(d) { return d.x - 40; }) // 垂直居中：x 是垂直坐标！
.style("fill", function(d) { return d._children ? pbi.colors[0] : pbi.colors[1]; });? 关键理解：d3.layout.tree().projection(...) 中 function(d) { return [d.y, d.x]; } 已将数据坐标 (x,y) 映射为 SVG 坐标 (y,x)，因此 d.x 实际控制 SVG 的 y 位置，d.y 控制 x 位置。
? 进阶优化（推荐）
-
动态计算最大深度，避免硬编码：
function getMaxDepth(node, depth = 0) { if (!node.children || node.children.length === 0) return depth; return Math.max(...node.children.map(c => getMaxDepth(c, depth + 1))); } var maxDepth = getMaxDepth(root); -
启用 separation 函数（D3 v3 支持）提升兄弟节点间距：
tree.separation(function(a, b) { return (a.parent === b.parent) ? 2.5 : 3; // 同级更紧凑，跨级略宽松 }); -
添加 CSS 边框/阴影辅助识别边界（调试用）：
.node rect { stroke: #333; stroke-width: 1.5; }
⚠️ 注意事项
- Power BI 的 pbi.dsv 返回的是数组对象，确保 data 在 update() 中仍可访问（当前代码中 totalRevenue 计算处 data 作用域可能失效，建议将 totalRevenue 提前计算并闭包保存）；
- 若升级到 D3 v5+，请改用 d3.tree().nodeSize([nodeHeight, nodeWidth])，语义更清晰；
- Zoom 行为下，.attr("transform") 应施加于
而非
通过以上调整，节点将严格按布局引擎计算的坐标分布，彻底解决重叠问题，同时保持交互性与响应式缩放能力。
