用 AI 自动配置 Next.js 部署 Vercel 环境

解决 Next.js 项目部署 Vercel 时的环境配置难题:自动管理多环境变量、区分 Edge 与 Serverless 运行时、处理跨域与缓存策略,确保生产环境安全与性能。

为什么需要这个技能

Next.js 迁移到 Vercel 并非简单上传代码,涉及复杂的环境变量隔离与运行时选择。特别是 NEXT_PUBLIC_* 前缀变量会打包进客户端代码,暴露密钥风险。此外,Vercel Serverless 函数有 50MB 大小限制和超时限制,Edge 运行时不支持 Node.js 标准 API。

AI 能自动帮你区分开发、预览、生产环境,检测敏感变量错误暴露,并针对大文件包优化冷启动速度,避免部署失败。

适用场景

  • 新项目初始化,需要在 Vercel 创建多环境(Dev/Preview/Prod)。
  • 处理 API 跨域请求被浏览器拦截(CORS)的问题。
  • 数据库 URL 等敏感配置在构建时泄露导致运行时错误。
  • 静态页面更新后数据不刷新,或动态资源加载缓慢。
  • 使用 Edge 运行时调用 fspath 等 Node 原生模块导致报错。

核心工作流

  1. 环境隔离:在 Vercel Dashboard 设置 ProductionPreviewDevelopment 三套变量。生产环境使用真实数据库与密钥,预览环境使用测试数据,严禁混淆。
  2. 运行时选择
    • 简单中间件或鉴权逻辑用 edge 运行时,体积小快。
    • 涉及数据库查询、文件操作或调用复杂库时用 nodejs 运行时。
    • 注意 Edge 不支持 fspath 等模块,需改用 crypto.subtle 或异步流。
  3. 构建优化:配置 next.config.js 使用 standalone 输出,利用动态导入处理大依赖,添加 Bundle Analyzer 分析包体积。
  4. 缓存控制:对动态页面设置 revalidate,或通过 revalidatePath 在服务端修改数据后手动清除缓存。

下载和安装

下载 vercel-deployment 中文版 Skill ZIP

解压后将目录放入你的 AI 工具 skills 文件夹,重启工具后即可使用。具体路径参考内附的 USAGE.zh.md

你可能还需要

暂无推荐