用途:用于在 Vercel 云平台部署前端框架与无服务器函数,处理自动 CI/CD、预览部署和边缘基础设施配置。适合静态站点、SSR 框架(Next.js、SvelteKit、Nuxt)、Serverless API 路由、边缘函数、按 PR 的预览环境以及 monorepo 部署。不适合长时后端进程、WebSocket 服务、重计算负载和需要持久文件系统的应用。
主要能力:项目配置可用 vercel.json 或 vercel.ts(配合 @vercel/config,支持类型化动态配置);rewrites 在不改变 URL 的情况下转发请求,redirects 改变 URL(permanent: true 表示 301),headers 按路径模式设置响应头,cleanUrls 去除 .html,trailingSlash 统一 URL 格式。环境变量在控制台或通过 vercel env 管理,按 production、preview、development 作用域划分。预览部署随 PR 自动生成唯一 URL。边缘函数用 export const runtime = 'edge',运行于 V8 隔离环境、低延迟但 Node.js API 受限;Serverless 函数位于 api/ 目录或框架路由,使用 Node.js 运行时。新项目默认启用 Fluid compute(默认时长 300s),另支持滚动发布、防火墙规则和批量重定向。
使用方式:本地可用 vercel 触发预览部署,vercel --prod 部署到生产,vercel promote <url> 将已有预览提升为生产。CI 中建议先 vercel build 再 vercel deploy --prebuilt。GitHub 集成推送即自动部署。自定义域名在 Project Settings > Domains 配置,顶级域用 A 记录、子域用 CNAME。
限制与常见问题:边缘运行时无 fs、path、process;VERCEL_URL 不含协议需手动加 https://,稳定生产 URL 用 VERCEL_PROJECT_PRODUCTION_URL;静态重定向上限 1024 条,超出用 bulkRedirects;maxDuration 受套餐限制(Hobby 60s、Pro 300s、Enterprise 最高 900s);需同时添加顶级域与 www 域名,避免其一 404;注意清理冲突 DNS 记录;monorepo 需在控制台设置各项目根目录。更多细节暂未提供。