uni-app 用 Vue3 做路由守卫，和 vue-router 不同——它跑在多端、没有浏览器 history，守卫要落在自己的路由 API 上。本文用未登录跳转登录页这场景，讲清跳转发起处拦截、onLoad 拦截、全局 addInterceptor 三种方式的配置与取舍，并给出可直接运行的代码。读完你能选出适合体量的落点组合，避免重定向死循环、拦截不生效这类典型坑。

watch 赋值了却没触发、改深层字段静悄悄？本文讲清 Vue2 里 watch 只在“监听目标产生新值”时触发，对象数组默认浅层比引用；immediate 管创建时先跑一次，deep 管递归比较每一层。点出对象内部改动未开 deep、数组索引赋值不被监听两个坑，并提醒 Vue3 响应式已换思路，照着配监听就能精准生效。

用 Vue3 在前端把页面导出成 word 文档时，图片常常本地预览正常、导出却是空白块。本文讲清 canvas 转 base64 内联、fetch 转码、docx 登记图片部件三种写法，并指出加载未就绪、跨域被污染、外链图不拉取三个常见空白原因与修复。

Vue3 多级路由下 keep-alive 缓存常配了却没生效，根因几乎都在 include 匹配的是组件名而非路由名。本文讲清怎么用 include 精确命中内层页面、用 key 区分动态路由，并列出三个最常踩的坑与修复，让缓存稳稳生效。

在 Vue 项目里集成天地图时，瓦片加载不全、首次空白最常见。本文讲清容器宽高为 0、DOM 未就绪就初始化、异步数据回来后没重算尺寸三类根因，并给出 onMounted、nextTick 与 checkResize 的修复写法。照着做就能让地图稳定显示，不再忽好忽坏。

在 Vue 项目里引入组件或依赖时，找不到模块、路径解析失败最常见。本文讲清相对路径层级数错、@ 别名没配置、扩展名与包名写错三类根因，并对比 Vite 与 Webpack 的解析差异与构建期报错。照着做就能一次写对导入路径，不再被 Cannot find module 反复打断。

Vue 文件失去智能提示，多数不是编辑器的锅，而是语言服务扩展冲突或工程配置没被读到。本文按四步讲清 Vetur 与 Volar 的取舍、takeover 模式的作用、tsconfig 与 jsconfig 的 include 范围，以及用父目录打开工作区导致的失效，附可复现的排查清单。

Vue 后台改登录接口名有三处可动：请求封装里的接口地址常量、开发服务器的代理转发规则、环境变量里的统一前缀。本文用一个登录请求讲清三种改动的生效范围、常见坑与打包后必须再验一遍的原因。

表格无限滚动其实是三种需求：匀速自动轮播、触底自动加载下一页、大数据量虚拟渲染。本文按两个问题分流，给出定时器自动滚动与交叉观察器触底加载的最小实现，说明虚拟列表真正适用的门槛和它的四项代价，并附重复请求、白屏等失败分支。

Vue 深层组件的事件跨层上报有三种做法：逐层 emit、上层 provide 注入函数让深层 inject 调用、以及把数据放进共享响应式容器。选择的关键是先判断这个事件是通知还是共享数据。本文用三层嵌套结构给出三种写法的代码、适用范围与代价，并附静默失效等失败分支。