Vercel 微前端
将大型应用拆分为独立部署的单元,使它们作为统一的整体应用展示给用户。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预选组)inspect-group—— 获取组元数据(项目名称、框架、Git 仓库、根目录);有助于自动化设置(选项:--group、--format=json、--config-file-name)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 防火墙、微前端 WAF 规则 | references/security.md |
当用户询问特定主题时,使用 grep 或搜索相关参考文件来查找答案,避免将全部参考内容加载到上下文中。