在 Power BI 报表嵌入场景中，使用 JavaScript API 切换至移动布局（如 MobilePortrait）后，若需恢复默认桌面视图，不能仅设置 LayoutType.Master 或 LayoutType.Custom，而必须显式指定 customLayout 及其 displayOption: FitToPage。
在 power bi 报表嵌入场景中，使用 javascript api 切换至移动布局（如 `mobileportrait`）后，若需恢复默认桌面视图，不能仅设置 `layouttype.master` 或 `layouttype.custom`，而必须显式指定 `customlayout` 及其 `displayoption: fittopage`。
Power BI JavaScript SDK 中的 layoutType 并非独立决定视觉呈现的唯一参数——尤其在从移动布局切回桌面布局时，models.LayoutType.Master 实际对应的是“原始画布尺寸”（即未缩放、按设计分辨率渲染），而用户通常期望的“桌面布局”效果是自适应容器、内容完整可见的视图，这需通过 Custom 布局配合 displayOption 实现。
✅ 正确做法：使用 LayoutType.Custom 并配置 customLayout.displayOption 为 FitToPage（推荐）或 ActualSize：
// 切换至桌面布局（推荐：自动缩放以适配容器）
const desktopSettings = {
layoutType: models.LayoutType.Custom,
customLayout: {
displayOption: models.DisplayOption.FitToPage
}
};
await report.updateSettings(desktopSettings);
⚠️ 注意事项：
-
models.LayoutType.Master不等价于“常规桌面视图”，它会强制以报表原始分辨率（如 1920×1080）渲染，可能导致溢出或需滚动，且无法响应容器尺寸变化； -
models.LayoutType.Custom是唯一支持displayOption的布局类型，FitToPage会等比缩放整个报表以完全适配父容器，ActualSize则保持原始像素尺寸（不缩放）； - 务必确保
report对象已完全加载（监听'loaded'事件后再调用updateSettings），否则设置可能被忽略； - 若页面存在 CSS
transform、scale或 iframe 缩放等干扰样式，也可能导致布局表现异常，建议检查容器层级渲染上下文。
? 小结：Power BI 嵌入布局切换本质是“布局类型 + 显示策略”的组合控制。移动布局只需指定 LayoutType.MobilePortrait，而回归桌面体验必须走 Custom 路径并明确 displayOption ——这是官方文档中易被忽略的关键约定。
