微信小程序如何配置全局参数

### 微信小程序 `app.json` 配置文件参数详解 `app.json` 是微信小程序的全局配置文件，用于定义小程序的整体结构和行为特性。以下是该文件的主要参数及其功能描述： #### 1. **pages** `pages` 字段是一个数组，表示小程序的所有页面路径列表。这些路径会按照顺序注册到小程序中，并决定小程序的启动页以及页面栈的行为[^2]。 ```json { "pages": [ "pages/index/index", "pages/logs/logs" ] } ``` #### 2. **window** `window` 对象用于设置小程序的状态栏、导航条等界面的表现形式。常见的配置项包括但不限于以下内容: - **navigationBarTitleText**: 导航栏标题文字。 - **navigationBarBackgroundColor**: 导航栏背景颜色。 - **navigationBarTextStyle**: 导航栏标题颜色风格（支持 black 和 white）。 - **backgroundColor**: 背景颜色。 - **backgroundTextStyle**: 下拉 loading 的样式（支持 dark 和 light）。 示例代码如下： ```json { "window": { "navigationBarTitleText": "首页", "navigationBarBackgroundColor": "#ffffff", "navigationBarTextStyle": "black", "backgroundColor": "#eeeeee", "backgroundTextStyle": "dark" } } ``` #### 3. **tabBar** 如果需要在小程序底部显示标签栏，则可以通过 `tabBar` 进行配置。主要字段有 `list`, `color`, `selectedColor`, `borderStyle` 等。 - **list**: 数组，指定 tabbar 上每个按钮的内容及跳转目标。 - **color**: 文字默认颜色。 - **selectedColor**: 当前选中的文字颜色。 - **borderStyle**: 底部边框的颜色（仅支持 black 或 white）。 示例代码如下： ```json { "tabBar": { "list": [ { "pagePath": "pages/index/index", "text": "首页", "iconPath": "assets/home.png", "selectedIconPath": "assets/home-active.png" }, { "pagePath": "pages/logs/logs", "text": "日志", "iconPath": "assets/log.png", "selectedIconPath": "assets/log-active.png" } ], "color": "#999", "selectedColor": "#000", "borderStyle": "white" } } ``` #### 4. **networkTimeout** 此对象用来设定各种网络请求的最大超时时间（单位为毫秒）。常见选项包括 `request`, `connectSocket`, `uploadFile`, `downloadFile` 等。 示例代码如下： ```json { "networkTimeout": { "request": 10000, "connectSocket": 10000, "uploadFile": 10000, "downloadFile": 10000 } } ``` #### 5. **debug** 当设置为 true 时，开发者工具上会展示详细的调试信息；生产环境中建议将其关闭以提升性能。 示例代码如下： ```json { "debug": false } ``` --- ### 总结 以上是对 `app.json` 文件各参数的具体解释。通过合理配置上述字段，可以实现对小程序整体外观与交互逻辑的有效控制。 ```json { "pages": ["pages/index/index", "pages/logs/logs"], "window": { "navigationBarTitleText": "示例程序", "navigationBarBackgroundColor": "#fff", "navigationBarTextStyle": "black" }, "tabBar": { "list": [ { "pagePath": "pages/index/index", "text": "首页" }, { "pagePath": "pages/logs/logs", "text": "日志" } ], "color": "#ccc", "selectedColor": "#000" }, "networkTimeout": { "request": 8000 }, "debug": false } ```