真机访问页面空白或404，根本原因是开发服务器默认仅监听127.0.0.1；需在vite.config.ts中显式配置server.host: "0.0.0.0"（vite）或vue.config.js中设devserver.host: "0.0.0.0"并启用disablehostcheck，重启后用netstat验证监听状态。
真机访问页面空白或404：server.host 配置必须显式设为 "0.0.0.0"
WebStorm 启动的 Vue 开发服务器默认只监听 127.0.0.1，手机通过局域网 IP（如 192.168.1.100:5173）访问时，请求直接被拒绝或静态资源返回 404。这不是 WebStorm 设置问题，而是开发服务器本身未开放外部连接。
Vite 项目：在 vite.config.ts 中必须写明：
server: { host: "0.0.0.0" }注意：host: true 在 Vite 2.x+ 已失效，必须用字符串。
Vue CLI 项目：在 vue.config.js 中添加：
devServer: { host: "0.0.0.0", disableHostCheck: true }
- 改完后重启服务，别只刷新页面
- 验证是否生效：终端执行
netstat -an | grep :5173（把端口号换成你的），看到*.5173或0.0.0.0:5173才算成功；若只显示127.0.0.1:5173，说明配置没加载 - macOS 用户需检查「系统设置 → 隐私与安全性 → 防火墙」是否拦截了该端口
WebStorm 断点在真机访问时完全不命中：Remote URL 映射不能用 vite:/// 或 webpack:/// 前缀
你在 Chrome DevTools 的 Sources 面板里能看到 vite:///src/App.vue，但这是浏览器在 localhost 下解析的虚拟协议；手机访问 http://192.168.1.100:5173/ 时，实际加载的是普通 HTTP 资源，vite:/// 根本不被识别——所以 WebStorm 按这个前缀去匹配源码，必然失败。
正确做法是关闭 JavaScript Debug 配置，改用 Node.js 启动调试：
