结论：别在 main.js 里挂 Vue.prototype，H5 可能正常但小程序和 App 端失效或响应式丢失；跨端稳定方案只有两种：用 globalData 存只读配置，或用 Vuex/Pinia 管理响应式状态。
直接说结论：别在 main.js 里瞎挂 Vue.prototype，H5 可能跑得通，小程序和 App 端大概率失效或响应式丢失；真正跨端稳定、可维护的方式只有两种：用 globalData 存只读配置类数据，或用 Vuex/Pinia（uni-app 3.0+）管响应式状态。
为什么 Vue.prototype.$xxx 在小程序里不工作
uni-app 编译到微信/支付宝等小程序时，并不是运行标准 Vue 实例，而是通过自研 runtime 桥接。Vue.prototype 的挂载逻辑在小程序环境被跳过或截断——你写进去了，this.$apiUrl 在页面里就是 undefined。
- 常见错误现象：
Cannot read property 'xxx' of undefined，尤其出现在分包页面、onLoad或异步回调中 - 即使 H5 端显示正常，也别信——它绕过了响应式追踪，
data里用this.$xxx初始化后，后续改值不会触发视图更新 - TypeScript 下无类型提示，
this.$utils不会自动推导接口，容易拼错或漏调用 - 如果真要用（比如仅限 H5 + App 联合调试），必须加前缀如
$my，且所有组件里避免重名覆盖（例如不要同时定义this.$http和第三方插件的this.$http）
globalData 是什么，怎么安全用
globalData 不是“全局变量”，它是 App 实例上的一个普通 JS 对象，靠 getApp() 拿到引用才能访问。它跨端最稳，但天生非响应式。
- 必须在
App.vue的data()函数里返回，不能写成data: { globalData: {...} }（H5 失效），也不能用箭头函数（this绑定错误） - 读取时永远先判空：
const app = getApp(); if (app && app.globalData) { ... }—— 尤其在onLoad、computed或异步回调里，H5 端getApp()可能返回undefined - 写操作别直接赋值：
app.globalData.token = 'xxx'可以，但页面不会重绘；如需同步更新视图，要么手动this.$forceUpdate()，要么封装成方法并配合事件总线通知 - 别塞大对象或数组：
globalData.list = hugeArray容易内存驻留，且修改数组项（如push）不会触发任何响应
Vuex/Pinia 怎么在 uni-app 里正确挂载
如果你需要 token 变更后自动刷新用户头像、主题切换实时生效、购物车数量全站联动——那就必须上状态管理。但 uni-app 不会自动把 store 注入所有组件，得手动桥接。
- 在
main.js中显式挂载：Vue.prototype.$store = store（H5/APP 有效），但小程序端不认这个；所以更稳妥的做法是：每个用到 store 的页面都import store from '@/store'直接引用 - state 里禁止放不可序列化内容：函数、正则、Date 实例、DOM 节点——小程序 setData 会报错甚至白屏
- 多端编译时，
store文件建议用export default new Vuex.Store({})，别用工厂函数，否则分包加载可能 new 多次实例 - Pinia（uni-app 3.0+ 支持）更推荐：无需
Vue.use，defineStore写法更简洁，且 TypeScript 支持更好；但注意小程序端仍要避免在state里存Map/Set
什么时候该用公共模块（/common/utils.js）
当你只需要共享纯函数、常量、工具方法，且不依赖响应式、不跨 vue/nvue 页面通信时，这是最轻量、最可控的选择。
- 适用场景：
formatTime、isPhone、API_BASE_URL、ENV枚举 - 注意：vue 页面和 nvue 页面无法共用同一个模块文件——nvue 不支持 ES Module 动态导入，必须用
require，且路径写法不同（如require('@/common/utils.js')） - 别在模块里写副作用代码（比如初始化 localStorage），模块应保持纯函数特性；副作用统一收口到
App.vue的onLaunch - 如果项目已用 TypeScript，给模块加
declare module '@/common/utils'类型声明，否则 import 后无类型推导
最常被忽略的一点：globalData 和 Vuex 混用时，token 更新必须走同一入口——比如登录成功后，既要 app.globalData.token = xxx，也要 store.commit('SET_TOKEN', xxx)，否则某端读的是旧值，另一端读的是新值，状态就撕裂了。
