微信小程序底部tabBar不显示图标

现场还原

在设置微信小程序底部tabBar导航图标时,无论如何操作均无法显示在界面上

解决思路

问题1 图标类型

一开始以为不支持png类型,但查看官方API仅提示ICON尺寸大小

打开其他项目可以正常展示,排除图标类型问题

js 复制代码
iconPath	string	否	图片路径,icon 大小限制为 40kb,建议尺寸为 81px * 81px,不支持网络图片。 当 position 为 top 时,不显示 icon。

问题2 图标路径设置问题

按住ctrl 和 鼠标左键点击 均可跳转查看对应图标 说明资源路径无问题

js 复制代码
 "iconPath" : "/images/b_2.png",
 "iconPath" : "images/b_2.png",

问题3 pages和tabBar中定义第一个页面不一致

有网友描述是
app.jsonpages中的第一个页面不是tabBar配置中list[0]的第一个页面大导致

模拟示例:

js 复制代码
  "pages":[
    "pages/index/index",
    "pages/welcome/welcome",
    "pages/cart/cart",
    "pages/type/type",
    "pages/details/details",
    "pages/home/home",
    "pages/logs/logs"
  ],
  "tabBar": {
    "color": "#AAAAAA",
    "selectedColor": "#F20A0A",
    "borderStyle": "black",
    "backgroundColor": "#ffffff",
    "list": [
      {
        "pagePath": "pages/type/type",
        "text": "类型",
        "iconPath" : "/images/b_2.png",
        "selectedIconPath" : "/images/b_5.png"
      },
      {
        "pagePath": "pages/index/index",
        "text": "首页",
        "iconPath" : "images/b_1.png",
        "selectedIconPath" : "images/b_5.png"
      },
      {
        "pagePath": "pages/details/details",
        "text": "详情",
        "iconPath" : "images/b_3.png",
        "selectedIconPath" : "images/b_5.png"
      },
      {
        "pagePath": "pages/cart/cart",
        "text": "购物车",
        "iconPath" : "images/b_4.png",
        "selectedIconPath" : "images/b_5.png"
      },
      {
        "pagePath": "pages/home/home",
        "text": "我的",
        "iconPath" : "images/b_5.png",
        "selectedIconPath" : "images/b_5.png"
      }
    ]
  },

效果展示:

顺序互不干涉 是可以显示的!!!

问题4 真机调试图片超200K或文件超上限2M

  • 真机调试文件超2M(message:Error: 代码包大小为2100 kb,上限为 2048 kb,请删除文件后重试。

如果小程序端文件超大。如果是在4M以内,可以更换微信开发者版本解决。

js 复制代码
详情 -> 本地设置勾选 ->  预览及真机调试时主包、分包体积上限调整为4M

问题5 重启微信开发者工具

比较尴尬的是,一顿操作猛如虎,一看战绩零杠五!!!

上面所有的操作全部执行了一遍后,点击刷新界面,小程序还是无反应!!!

后面不小心勿关了编辑工具,重启后,发现一切又正常啦!

总结

可能是以下几个原因导致底部tabBar不显示图标:

  • 图标路径错误:请检查图标路径是否正确,建议使用相对路径。

  • 图标大小不符合要求:请确保图标大小符合微信小程序的要求,建议使用官方提供的图标模板。

  • tabBar配置错误:请检查tabBar的配置是否正确,包括图标路径、选中态图标路径、文字等。

  • 页面路径错误:请检查页面路径是否正确,如果路径错误,可能会导致tabBar不显示。所指向的页面未进行页面注册。

  • 编程界玄学薛定谔的bug 重启软件或电脑 解决99%问题

相关推荐
show4335 小时前
2026微信小程序视频转文字多语种识别引擎技术选型:22种方言25种外语挑战
微信小程序·小程序·音视频
MrFlySand_飞沙14 小时前
uniapp开发微信小程序实现接入企业微信客服
微信小程序·小程序·uni-app·企业微信
码艺-Alimjan14 小时前
JWT 的本质、误区与正确落地:一套不依赖任何框架的架构方法论-微信小程序代码案例-Api 安全性拉满
微信小程序·架构·notepad++
禁止摆烂_才浅14 小时前
微信小程序高频面试题
前端·面试·微信小程序
show43315 小时前
2026微信小程序批量处理视频文件架构方案:免费批量实测
微信小程序·小程序·架构
wordbaby1 天前
从双端内卷到一库多端:基于 pnpm + Taro 4 + RNOH 鸿蒙的 Monorepo 跨端架构实战
前端·微信小程序·app
码云之上3 天前
小程序 iOS 多输入框焦点乱序脱坑记
ios·微信小程序·taro
Greg_Zhong5 天前
微信小程序 + 腾讯云人体分析:从 0 到 1 实现 AI 抠图打卡合照(细节待更新~)
人工智能·微信小程序·腾讯云·ai抠图-ai打卡拍照
java1234_小锋7 天前
【免费】基于Python的微信小程序网约车(打车,在线叫车,移动出行)系统(FastAPI+Vue3) 锋哥原创出品,必属精品
微信小程序·小程序·fastapi·网约车系统·在线叫车系统
拖孩8 天前
用 AI 重解千年观音灵签,做了一个微信小程序,每天摇一摇,命运给你回应
前端·后端·微信小程序