Vue项目在iOS Safari浏览器上白屏崩溃怎么排查？
Vue项目在iOS Safari上白屏，这事儿说难也难，说简单也简单。说到底，多半是JS执行到一半直接停了，或者组件挂载失败，导致整个Vue实例压根儿没起来。你打开页面，看着一片空白，连个报错都没有，这时候千万别慌——Mac加Safari真机调试是唯一的正道。 用Mac+Safari直连真机抓控制台
Vue项目在iOS Safari上白屏，这事儿说难也难，说简单也简单。说到底，多半是JS执行到一半直接停了，或者组件挂载失败，导致整个Vue实例压根儿没起来。你打开页面，看着一片空白，连个报错都没有，这时候千万别慌——Mac加Safari真机调试是唯一的正道。
用Mac+Safari直连真机抓控制台错误
打开Mac上的Safari，顶部菜单栏找到「开发」，你的iPhone设备名应该就在那儿。点一下，找到当前打开的Vue页面标签。前提是iPhone上「设置→Safari→高级→Web检查器」已经开着，并且Mac和iPhone在同一个Wi-Fi下。如果开发菜单里不显示设备，别着急，重启iPhone的Safari，重新连一下USB线。
切到Console面板，刷新页面，盯紧红色报错行。SyntaxError、TypeError，或者是“Can't find variable: Promise”，随便哪一条冒出来，都比一片死寂强——那才是白屏的真正祸根。
检查#app是否被创建但未挂载
在Safari开发者工具的Elements面板里，搜一下 有两种方法可以兜住那些悄悄吞掉的错误。 方法一：补全未捕获的Promise拒绝错误。在main.js最顶部加上： 方法二：拦截同步脚本错误。紧接在上代码下方加： 这两段代码必须放在任何import语句之前，否则早期错误根本抓不住。漏掉这一句，async/await里抛出的错误会静默吞掉，白屏之后连个日志都查不到。 第一步：确认项目是否引入了babel-polyfill或core-js。打开src/main.js，看看有没有 第二步：检查babel配置里iOS目标版本是否锁定了。打开babel.config.js，确认presets中是不是这样配的： 第三步：临时降级测试。在vue.config.js中强制关闭代码压缩，避免UglifyJsPlugin误伤： 打开Safari的Network面板，刷新页面，看看index.html之后的首个JS或CSS请求是不是返回了404或500。如果用的history模式，检查服务器有没有配好fallback——所有非静态资源请求都应该返回index.html。要是本地直接双击打开dist/index.html，那必须把vue.config.js里的 火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力，依托字节自研豆包多模态大模型，凭借火山方舟一站式平台，提供模型精调、推理部署、智能应用搭建等全链路服务，结合高性能AI算力，助力各行业快速落地大模型数字化与智能化应用。 AirBuddy 3 是面向 macOS 的蓝牙外设增强工具，可集中查看 AirPods、Beats 与苹果设备电量，提供快速连接、播放控制、电量提醒、桌面小组件和多台 Mac 外设接力等功能。 AirServer macOS版可把 Mac 转换为无线投屏接收端，通过 AirPlay 或 Google Cast 接收手机、平板和电脑画面，并支持多设备同时连接、高清镜像及会话录制，适合家庭娱乐、课堂教学、会议演示和应用展示。 火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力，依托字节自研豆包多模态大模型，凭借火山方舟一站式平台，提供模型精调、推理部署、智能应用搭建等全链路服务，结合高性能AI算力，助力各行业快速落地大模型数字化与智能化应用。 PixTV 是一款在浏览器中使用的 AI 视觉内容创作平台，提供图片、视频、音频、文字生成、AI 分镜、局部重绘、提示词反推和无限画布等工具，适合短剧、漫剧、广告及社交媒体内容制作。 Autodesk Maya 是面向影视、电视、动画和游戏行业的专业三维制作软件，集多边形与 NURBS 建模、角色绑定、关键帧和动作捕捉动画、Bifrost 特效模拟、材质开发及 Arnold 渲染于一体，new Vue()是执行了，但mounted钩子没触发。问题就卡在created或beforeMount阶段。要是整个在main.js入口注入全局错误捕获
window.addEventListener('unhandledrejection', e => { console.error('Unhandled Rejection:', e.reason); });window.onerror = (msg, url, line, col, error) => { console.error('Global Error:', { msg, url, line, col, error }); };快速验证是否为ES特性兼容问题
import 'core-js/stable'; import 'regenerator-runtime/runtime';（Vue CLI 3+推荐）或import 'babel-polyfill';（旧版做法）。{ targets: { ios: '12.1' } }。iOS 12.1起对大部分ES2018特性支持不错，但要是项目需要覆盖iOS 10或11，那就要启用safari10: true选项，还得关上mangle，否则压缩变形。configureWebpack: { optimization: { minimize: false } }。重新build、部署、真机验证。如果白屏消失了，那问题就锁死在压缩环节。排查路由模式引发的404白屏
publicPath设成'./'，不能是'/'。路径解析失败，JS加载404，Vue根本启动不了。这一步很简单，直接把文件拖进去就行。
