1. uniapp Vue3 项目中设置 "custom": true 自定义底部导航栏失败


在 uniapp Vue3 项目中设置 "custom": true 自定义底部导航栏失败,主要原因如下:
1.1. Vue3 限制
Vue3 限制:根据迁移文档 migration-to-vue3 > 小程序自定义组件,Vue3 项目已不再支持传统的小程序自定义组件方式(包括自定义 tabBar)。
1.2. 配置规范
(1)需在 pages.json 中正确配置 tabBar 的 "custom": true;
(2)必须创建 custom-tab-bar 目录(仅微信小程序支持此方式);
(2)App 端需使用 subNVue 或前端模拟方案。
1.3. 替代方案:
(1)推荐使用 uni-app 官方提供的 custom-tab-bar 组件;
(2)或前往插件市场搜索 tabbar 相关插件;
(3)App 端建议使用 subNVue 方案(subNVue 文档)。
注意:自定义 tabBar 在 App 和小程序端性能体验低于原生实现,非必要不建议自定义。确保你的 HBuilderX 版本为 4.87+,并检查 pages.json 配置是否符合 Vue3 规范。