技术博客

UniApp、Nuxt、Vue 实战踩坑与报错修复笔记（z-paging、RootPortal、payload.json、Wagmi 等）

踩坑2026年7月29日

Unibest build:app 后 manifest 缺 tabBar：wgt 热更新白屏修复

Unibest 默认安装后执行 build:app，产物 manifest.json 丢失 pages.config.ts 的 tabBar 等配置，导致 wgt 热更新安装后 App 白屏。本文说明原因与修复步骤。

qibmz

踩坑2026年7月27日

UniApp 配置 z-paging easycom 后与 @uni-helper/vite-plugin-uni-components 冲突，CICD 打包 H5 构建成功但页面组件渲染为原始标签。本文给出冲突原因与修复方式。

qibmz

工具2026年5月19日

Apifox 官方未写清 VS Code Copilot 的 MCP 接入步骤。本文给出 mcp.json 配置、鉴权与验证方法，让 Copilot 直接读取 Apifox API 文档。

qibmz

UniApp2026年4月22日

UniApp 深层组件里的 Popup、Modal 遮罩被父级 overflow/z-index 裁切或盖住时，用 RootPortal 传送到页面根节点解决；适用于 uview-plus 等弹层组件。

qibmz

踩坑2026年4月7日

UniApp / 微信小程序常见坑：uni.showModal 确认取消按钮文字字数限制、iOS 元素溢出视口、picker 时区偏差、以及未选中项背景色修改方法。

qibmz

工具2026年3月19日

nvm-windows 下载 Node.js 一直卡住时，不必改 settings.txt。用 nvm node_mirror / npm_mirror 切淘宝镜像或代理即可。

qibmz

Vue32026年2月5日

用 Vue 3 Composition API 与 requestAnimationFrame 实现数字滚动（CountUp）组件，覆盖取消动画、内存泄漏与性能优化。

qibmz