PWA 在 iOS 上 standalone 模式为啥不生效？

技术兴翰提问于 2026-03-24 10:53:22 阅读 27

移动

我给 PWA 加了 display: standalone，安卓上能全屏启动，但 iOS Safari 完全没反应，还是带浏览器地址栏。是不是 iOS 不支持？还是我哪里配置错了？

manifest.json 里已经设置了：

{
  "display": "standalone",
  "start_url": "/",
  "name": "My App"
}

也加了 meta 标签 <meta name="apple-mobile-web-app-capable" content="yes">，但依然不行，求解！

PWA移动

我来解答赞 5 收藏

反馈

1 条解答

Zz议谣 Lv1

在 iOS 上，PWA 的 standalone 模式有时候就是有点迷。首先确认一下 manifest.json 文件的路径是否正确，确保它被正确引用了。其次，iOS 对 manifest.json 的一些字段有特定的要求，比如 icons 字段，你需要提供不同尺寸的图标，并且每个图标对象需要包含 sizes 和 type 属性。最后，检查一下你的 HTTPS 设置，iOS 需要通过 HTTPS 访问才能安装 PWA。

建议改成这样试试：

{

  "display": "standalone",

  "start_url": "/",

  "name": "My App",

  "icons": [

    {

      "src": "/images/icons/icon-192x192.png",

      "sizes": "192x192",

      "type": "image/png"

    },

    {

      "src": "/images/icons/icon-512x512.png",

      "sizes": "512x512",

      "type": "image/png"

    }

  ]

}

别忘了，iOS 用户需要手动添加到主屏幕，不像安卓那样自动提示。有时候清理一下缓存或者重启 Safari 也能解决一些奇怪的问题。希望这些信息对你有帮助！

2026-03-24 11:00