Manifest 是一个英文单词,常见含义是 清单、声明、配置清单,具体取决于使用场景。
在软件开发领域,`manifest` 通常指一个描述应用程序、模块或资源相关信息的清单文件。
一、软件开发中的 Manifest
例如:
| 场景 | 文件名 | 主要作用 |
|---|---|---|
| Web 应用(PWA) | manifest.json | 定义应用名称、图标、启动地址等 |
| Vite 前端打包 | manifest.json | 记录源文件与打包后文件的映射关系 |
| Android 开发 | AndroidManifest.xml | 声明应用权限、组件、入口等 |
| Kubernetes | deployment.yaml 等 | 声明需要部署的资源及配置 |
| 浏览器扩展 | manifest.json | 定义插件名称、权限、脚本等 |
| Docker 镜像 | Image Manifest | 描述镜像层、配置及相关元数据 |
二、结合 Vite 举例说明
假设你的项目使用:
GoFrame + Vite + jQuery + AdminLTE 4 + Tabulator
开发环境中有:
frontend/ ├── src/ │ ├── common.js │ ├── crm/ │ │ └── customer.js │ └── srm/ │ └── supplier.js
Vite 打包后可能产生:
dist/
├── .vite/
│ └── manifest.json
└── assets/
├── common-a8f32.js
├── customer-b9c21.js
└── supplier-d7e43.js
其中 manifest.json 内容类似:
{
"src/common.js": {
"file": "assets/common-a8f32.js",
"src": "src/common.js",
"isEntry": true
},
"src/crm/customer.js": {
"file": "assets/customer-b9c21.js",
"src": "src/crm/customer.js",
"isEntry": true
},
"src/srm/supplier.js": {
"file": "assets/supplier-d7e43.js",
"src": "src/srm/supplier.js",
"isEntry": true
}
}
这里的 Manifest 相当于一张资源对应关系表。
比如:
- 开发时:`src/crm/customer.js`
- 打包后:`assets/customer-b9c21.js`
- GoFrame 服务端读取 Manifest,就能找到真正需要加载的 JS 文件。
实际项目中,Manifest 还可以记录 CSS、依赖的其他资源等。
三、Manifest 和 Config 有什么区别?
| 对比 | Manifest | Config |
|---|---|---|
| 中文理解 | 清单、声明文件 | 配置文件 |
| 核心作用 | 描述有什么、在哪里、依赖什么 | 控制系统如何运行 |
| 典型内容 | 文件映射、模块声明、资源信息 | 数据库连接、端口、开关 |
| 常见文件 | manifest.json | config.yaml |
两者并没有绝对界限,Manifest 也可能包含配置项。
一句话理解:
- Manifest:告诉系统“我有哪些东西”。
- Config:告诉系统“这些东西应该怎么运行”。
对于你现在采用的 GoFrame 服务端模板 + Vite 多模块打包方案,`manifest.json` 非常重要,它可以让 GoFrame 自动识别 Vite 打包后带 Hash 的 JS、CSS 文件,不需要在 HTML 模板中手工维护打包文件名。