minimal-ui 在现代浏览器中已完全失效，chrome 89+、edge 90+、firefox 85+、safari（ios 16.4+ 和 macos monterey+）均忽略该值并回退至 browser 模式，且会导致 ios safari 拒绝“添加到主屏幕”提示、pwa 检测失败等实际问题。
minimal-ui 在现代浏览器中已完全失效
minimal-ui 作为 viewport 的 content 值，自 2026 年起在所有主流浏览器中均不生效。它不是“部分支持”，而是被明确移除或忽略——Chrome 89+、Edge 90+、Firefox 85+、Safari（iOS 16.4+ 和 macOS Monterey+）全部不再识别该值，会直接 fallback 到 browser 模式。
哪些旧环境曾支持 minimal-ui
仅以下三类环境在历史版本中短暂支持过 minimal-ui，但均已退出实际维护场景：
- iOS Safari 7.1–15.x（仅限 iPhone，iPad 从未支持），需配合
<meta name="apple-mobile-web-app-capable" content="yes">才可能触发； - 老版 UC 浏览器（Android 4.x 时代）、QQ 浏览器（v6.x 及更早），仅作 UI 简化，不改变安装能力或 PWA 行为；
- Android Browser（即 Android 4.3 及更早系统自带浏览器），靠
window.scrollTo(0, 0)+touchmove.preventDefault()配合实现伪全屏，minimal-ui仅是辅助标记，非核心机制。
误用 minimal-ui 的实际后果
现在写 <meta name="viewport" content="width=device-width, initial-scale=1, minimal-ui"> 不会报错，但会导致：
- iOS Safari 拒绝触发「添加到主屏幕」提示，因为 manifest +
apple-mobile-web-app-capable+ 有效 display 值三者缺一不可，而minimal-ui不被认作合法 display 模式； - Chrome / Edge / Firefox 忽略该字段，
content剩余部分（如width=device-width）仍生效，但语义污染：开发者误以为有 UI 简化效果，实则无； - 部分 PWA 检测工具（如 Lighthouse 11+）会将含
minimal-ui的页面标记为「manifest display 值不合规」，影响 PWA 合格性评分。
替代方案必须匹配目标平台
如果你真正需要的是「隐藏地址栏」或「类原生体验」，应按平台分情况处理：
- 对 iOS：确保
manifest.json中display设为"standalone"，并配<meta name="apple-mobile-web-app-capable" content="yes">； - 对 Android Chrome：依赖
display: "standalone"+ 用户至少一次「添加到主屏幕」操作，之后才能稳定启用状态栏主题色与启动屏； - 对全屏需求（如游戏、演示页）：用
Element.requestFullscreen()，且必须由用户手势触发（如 click/tap），不能自动调用； - 不要试图用
minimal-ui兜底——它既不能保兼容，也不能补功能，只会增加调试困惑。
真正容易被忽略的点是：viewport meta 标签本身不控制 PWA 启动模式，它只影响页面渲染视口；display 行为由 manifest.json 的 display 字段和浏览器安装状态共同决定，minimal-ui 早已脱离这个链条。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
