vercel-microfrontends

Vercel Microfrontends

将大型应用拆分为可独立部署的单元，并将它们呈现为一个统一的应用。Vercel 使用 microfrontends.json 在其全球网络上处理路由。

**核心概念：**默认应用（包含 microfrontends.json，用于处理未匹配的请求）· 子应用（包含 routing 路径模式）· 资源前缀（防止静态资源冲突）· 独立部署。

**框架：**Next.js（App Router + Pages Router）、SvelteKit、React Router、Vite — 均通过 @vercel/microfrontends 使用。

CLI（vercel microfrontends / vercel mf）：

• create-group — 创建新组；默认采用交互模式，也可通过 --non-interactive 完全以非交互模式运行（选项：--name、--project（可重复指定）、--default-app、--default-route、--project-default-route（可重复指定，格式：<project>=<route>，非交互模式下每个非默认项目都必须指定）、--yes 跳过确认提示）；注意：如果添加项目会超出免费套餐限制，则会阻止使用 --non-interactive — 用户必须通过交互方式确认账单变更
• add-to-group — 将当前项目添加到现有组；需要交互式终端（选项：--group、--default-route）
• remove-from-group — 从所属组中移除当前项目；需要交互式终端（选项：--yes 仅跳过项目关联提示）
• delete-group — 删除一个组及其所有设置，此操作不可撤销；需要交互式终端（选项：--group 可预先选择组）
• pull — 拉取远程 microfrontends.json，用于本地开发（选项：--dpl）
• microfrontends proxy — 本地开发代理 · microfrontends port — 输出自动分配的端口

查找详细信息

此技能在 references/ 目录中包含详细的参考文档。请勿一开始就阅读所有参考文档。 当用户询问特定主题时，请搜索或 grep 相关文件：

主题	参考文件
入门、快速开始、框架设置、microfrontends.json 架构、字段、命名、示例	references/configuration.md
路径表达式、资源前缀、标志控制的路由、中间件	references/path-routing.md
本地代理设置、多仓库配置、Turborepo、端口、部署保护	references/local-development.md
检查组（inspect-group）、添加/移除项目、回退环境、导航、可观测性	references/managing-microfrontends.md
测试实用工具（validateMiddlewareConfig、validateRouting 等）、调试标头、常见问题	references/troubleshooting.md
部署保护、Vercel Firewall、面向 microfrontends 的 WAF 规则	references/security.md

当用户询问特定主题时，请使用 grep 或搜索相关参考文件，以便在不将所有参考文档加载到上下文中的情况下找到答案。