多页面前端开发

多页面前端（MPA）由多个页面入口组成。每个入口可以拥有自己的 HTML、路由边界和页面依赖，适合内容型网站、管理后台、营销页面以及需要独立发布多个入口的项目。

多页面不是把所有页面简单拆成多个目录。每个入口都应明确自己的启动方式、依赖、环境配置、访问权限和发布验证责任。

什么时候选择多页面

适合以下情况：

• 不同入口由不同业务团队或生命周期维护。
• 页面需要独立加载，不能因为一个入口的代码变更影响所有入口。
• 搜索引擎收录、首屏性能或页面级缓存是主要目标。
• 管理后台、用户端和公开网站需要不同的依赖和权限边界。

如果页面共享大量状态、交互和组件，并且需要在页面之间保持连续的客户端运行态，优先评估单页面前端，而不是为了目录结构强行采用多页面。

推荐项目边界

每个页面入口至少明确以下内容：

一个清晰的结构通常类似：

src/
  entries/
    public-site/
    admin/
    account/
  shared/
    components/
    api/
    types/
  pages/

实际目录名由项目技术栈决定，不要为了匹配示例而修改构建工具的既有约定。

开发与发布流程

1. 先列出所有入口、访问路径、面向用户和权限要求。
2. 为每个入口定义构建命令、公开环境变量和 API 依赖。
3. 复用共享组件和契约，但让页面业务状态留在对应入口内。
4. 在本地分别启动和验证每个入口，覆盖刷新、直接访问和不存在路径。
5. 构建后检查静态资源路径、缓存策略、错误页和部署平台的路由规则。
6. 对每个入口使用真实发布地址验证 API、鉴权、跨页面跳转和日志。

多页面项目的发布成功，必须同时满足入口可访问、资源加载正确和后端接口可用。某一个入口发布成功，不代表其他入口已经升级。

与平台应用的关系

普通多页面网站可以直接发布为 Web 站点。只有当某个入口需要显示在工作区应用入口、取得平台应用身份或调用已声明的平台能力时，才把它建成独立的 PLATFORM_APPLICATION 项目；前端源码和平台应用配置保存在同一项目，并由 Bundle 锁定其发布版本。