在使用 uni-app 开发项目时，我们会经常接触到两个最核心、最不能缺少 的 JSON 配置文件：pages.json 和 manifest.json。
很多新手会疑惑：这两个文件到底是干嘛的？能不能删？有什么区别？
这篇博客就用清晰、通俗、实战化的方式，带你彻底搞懂 pages.json 和 manifest.json 的作用、区别、使用场景，让你在开发 uni-app 时不再迷茫。
一、先一句话分清两者
- pages.json ：管页面 和全局样式、导航栏、tabBar等界面展示配置。
- manifest.json ：管项目本身，包括应用名称、图标、权限、各端发布配置。
一个管界面与页面 ，一个管项目与发布，分工非常明确。
二、pages.json 作用详解
1. 核心定位
pages.json 是 uni-app 的页面配置文件，用来告诉框架：
- 项目有哪些页面
- 页面的路径是什么
- 页面的标题、导航栏样式
- 底部 tabBar 菜单
- 全局下拉刷新、窗口样式等
它相当于小程序的 app.json，是 uni-app 启动时必须读取的文件。
2. 主要功能
- 注册页面
json
"pages": [
{ "path": "pages/index/index", "style": { "navigationBarTitleText": "首页" } },
{ "path": "pages/user/user", "style": { "navigationBarTitleText": "我的" } }
]- 必须在这里注册，页面才能被访问
- 第一项默认为首页
-
**全局样式配置（globalStyle）**统一设置导航栏颜色、文字颜色、背景色等。
-
底部 tabBar 配置配置 App 最常见的底部菜单。
-
条件编译、启动页、分包加载优化小程序和 App 性能。
3. 一句话总结
pages.json = 页面列表 + 界面样式 + 导航配置
三、manifest.json 作用详解
1. 核心定位
manifest.json 是 uni-app 的项目配置文件，用来描述整个应用的 "身份信息" 和 "运行环境"。
它决定了你的项目打包后变成什么 、叫什么名字 、拥有什么权限。
2. 主要功能
-
应用基础信息应用名称、版本号、入口页面、描述。
-
各端专属配置
- App 端：图标、启动页、权限、安卓 /iOS 配置
- 小程序端：appid、小程序基础库版本
- H5 端：网站标题、运行路径、打包配置
-
权限管理如摄像头、定位、相册、网络、推送等权限。
-
发布与打包控制控制打包后的应用行为、模块引用、是否开启原生渲染。
示例结构：
json
{
"name": "我的应用",
"appid": "__UNI__XXXXXXX",
"versionName": "1.0.0",
"app-plus": { "modules": {}, "distribute": { "icons": {} } },
"mp-weixin": { "appid": "wxXXXXXXX" },
"h5": { "title": "我的H5网站" }
}3. 一句话总结
manifest.json = 应用身份信息 + 各端打包配置 + 权限管理
四、pages.json 和 manifest.json 核心区别（表格速记）
表格
| 对比项 | pages.json | manifest.json |
|---|---|---|
| 作用 | 管理页面、导航、tabBar、界面样式 | 管理应用信息、打包、权限、各端配置 |
| 关注点 | 页面结构 + UI 样式 | 项目本身 + 发布环境 |
| 运行时影响 | 决定页面能否打开、样式是否正确 | 决定应用能否正常打包、运行、授权 |
| 修改后效果 | 立即生效 | 通常需要重新编译 / 运行 |
| 类比 | 相当于 "目录、导航、菜单" | 相当于 "身份证、户口本、打包说明书" |
| 是否必须 | 必须，无则无法启动 | 必须，无则无法打包发布 |
五、最容易混淆的 3 个问题
1. 我想修改应用名称，改哪个？
→ manifest.json
2. 我想新增页面、配置导航栏，改哪个？
→ pages.json
3. 我想配置小程序 appid，改哪个？
→ manifest.json
六、实战记忆口诀
plaintext
页面路由找 pages，
导航 tab 它都管；
应用身份看 manifest，
打包权限全靠它。七、总结
- pages.json ：负责页面和界面，控制你 "能看到什么"。
- manifest.json ：负责项目和发布，控制应用 "是什么、能做什么、能打包成什么"。
两者都是 uni-app 的核心基础配置，缺一不可，理解它们能让你更快掌握 uni-app 开发逻辑。
总结
- pages.json ：管理页面路径、导航栏、tabBar、全局样式，控制界面展示。
- manifest.json ：管理应用名称、版本、图标、权限、各端打包配置，控制项目本身。
- 两者分工明确，是 uni-app 项目必须存在、不可删除的核心配置文件。