摘要：作用：配置单个页面的窗口样式，覆盖全局 app.json 中的 window 配置。示例：
微信小程序的配置文件主要用于定义小程序的全局设置、页面路径、窗口样式、网络超时时间等。以下是主要配置文件的详细说明：
1. 全局配置文件：app.json
作用：配置小程序的全局设置，所有页面都会生效。主要字段：json
{
"pages": [ // 必填，注册所有页面路径（无需写后缀）
"pages/index/index",
"pages/logs/logs"
],
"window": { // 窗口全局样式
"navigationBarBackgroundColor": "#ffffff", // 导航栏背景色
"navigationBarTitleText": "小程序", // 导航栏标题
"navigationBarTextStyle": "black", // 导航栏文字颜色（black/white）
"backgroundColor": "#eeeeee", // 页面背景色
"enablePullDownRefresh": false // 是否开启全局下拉刷新
},
"tabBar": { // 底部/顶部 tab 栏配置
"list": [
{
"pagePath": "pages/index/index", // 页面路径
"text": "首页", // 显示文字
"iconPath": "images/tab_home.png", // 未选中图标
"selectedIconPath": "images/tab_home_active.png" // 选中图标
}
],
"color": "#999", // 文字默认颜色
"selectedColor": "#ff0000", // 选中文字颜色
"backgroundColor": "#fff" // tab 背景色
},
"networkTimeout": { // 网络请求超时时间
"request": 10000, // 单位毫秒
"connectSocket": 10000,
"uploadFile": 10000,
"downloadFile": 10000
},
"permission": { // 用户权限请求配置（如地理位置等）
"scope.userLocation": {
"desc": "需要获取您的地理位置"
}
}
}
2. 页面配置文件：页面名.json
作用：配置单个页面的窗口样式，覆盖全局 app.json 中的 window 配置。示例：json
{
"navigationBarTitleText": "首页", // 当前页面标题
"enablePullDownRefresh": true, // 当前页面开启下拉刷新
"usingComponents": {} // 声明页面使用的自定义组件
}
3. 项目配置文件：project.config.json
作用：配置开发工具的项目设置（如 AppID、项目名称、编译配置等）。常用字段：json
{
"description": "项目描述",
"setting": {
"urlCheck": true, // 是否检查安全域名和 TLS 版本
"es6": true, // 是否启用 ES6 转 ES5
"postcss": true, // 是否启用 PostCSS 处理 CSS
"minified": true // 是否压缩代码
},
"projectname": "MyProject", // 项目名称
"compileType": "miniprogram" // 编译类型（miniprogram/plugin）
}
4. Sitemap 配置文件：sitemap.json
作用：控制小程序页面是否允许被微信搜索索引。示例：json
{
"rules": [
{
"action": "allow", // allow 或 disallow
"page": "*" // 匹配所有页面
},
{
"action": "disallow",
"page": "pages/secret", // 禁止特定页面被索引
"params": ["id"] // 禁止带特定参数的页面
}
]
}
5. 其他配置文件
project.private.config.json：保存开发者个人的环境配置（如代理），不会被上传到版本管理。工具配置：如 .eslintrc（代码规范）、.prettierrc（代码格式化）等。常见注意事项
路径问题：pages 字段中的页面路径必须存在且正确，否则小程序无法启动。覆盖规则：页面级配置会覆盖全局配置（如 window 相关字段）。TabBar 限制：tabBar 的 list 最少 2 个、最多 5 个 tab。Sitemap 生效条件：需在微信后台开启“页面收录”功能。通过合理配置这些文件，可以高效管理小程序的页面结构、样式和功能。
来源：老客数据一点号