微信小程序中的app.json的作用

最新推荐文章于 2025-06-17 20:46:09 发布

原创最新推荐文章于 2025-06-17 20:46:09 发布 · 1.2w 阅读

20 ·

CC 4.0 BY-SA版权

微信小程序专栏收录该内容

11 篇文章

订阅专栏

本文详细介绍了微信小程序中app.json文件的配置方法及其各项功能，包括页面注册、窗口样式设置、多tab配置、网络超时时间设定及调试模式启用等内容。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

微信小程序中的app.json的作用

参考：开发文档

{
  "pages": [
    "pages/index/index",
    "pages/logs/index"
  ],
  "window": {
    "navigationBarTitleText": "Demo"
  },
  "tabBar": {
    "list": [{
      "pagePath": "pages/index/index",
      "text": "首页"
    }, {
      "pagePath": "pages/logs/logs",
      "text": "日志"
    }]
  },
  "networkTimeout": {
    "request": 10000,
    "downloadFile": 10000
  },
  "debug": true
}

app.json 用来对微信小程序进行全局配置，决定页面文件的路径、窗口表现、设置网络超时时间、设置多 tab 等。

(1)pages

作用：用来注册所有的页面，用字符串数组来表示，页面用【路径+文件名】来表示。字符串数组的一个页面为首页。

文件名不需要后缀，框架会自动寻找

.json,.wxss,.wxml,.js

的文件。

比如：

    pages/

    pages/index/index.wxml

    pages/index/index.js

    pages/index/index.wxss

    pages/logs/logs.wxml

    pages/logs/logs.js

    app.js

    app.json

    app.wxss

此时，在页面中就得写

{
  "pages":[
    "pages/index/index",
    "pages/logs/logs"
  ]
}

其中，

pages/index/index = pages/index(路径） + index(文件名）

pages/index/logs = pages/index(路径） + logs(文件名）

。

（2）window

作用：设置默认页面的窗口表现

{
    "window": {
    "navigationBarTitleText": "Demo"
  }
}

navigationBar；

background；

（3）tabBar:

作用：如果小程序是一个多 tab 应用，可以通过 tabBar 配置项指定 tab 栏的表现，以及 tab 切换时显示的对应页面。

{
  "tabBar": {
    "list": [{
      "pagePath": "pages/index/index",
      "text": "首页"
    }, {
      "pagePath": "pages/logs/logs",
      "text": "日志"
    }]
  }
}

参数：

list，tab 的列表，详见 list 属性说明，最少2个、最多5个 tab，

其中，list里的参数为pagePath（页面路径），text（文字），iconPath（图标），selectediconPath（选中时候的图标）

（4）networkTimeout

{
  "networkTimeout": {
    "request": 10000,
    "downloadFile": 10000
  }
}

作用：设置各种网络请求的超时时间。

request: wx.request的超时时间，单位毫秒，默认为：60000

downloadFile: wx.downloadFile的超时时间，单位毫秒，默认为：60000

(5) debug

作用：开启调试模式

{
 "debug": true
}

可以在开发者工具中开启 debug 模式，在开发者工具的控制台面板，调试信息以 info 的形式给出，其信息有 Page的注册， 页面路由， 数据更新， 事件触发 。可以帮助开发者快速定位一些常见的问题。