SuperAPI AI 工具集

vercel-local-dev-loop

编程与开发

查看项目

更新于 10-15 23:30

技能介绍

用途:在本地运行 Vercel 无服务器函数与 API 路由,覆盖环境变量管理、热重载、本地测试模式及框架自带的 dev server。使用时需已完成 vercel-install-auth 设置、通过 vercel link 关联项目,并使用 Node.js 18+ 与 npm/pnpm。

主要能力:vercel dev 会模拟 Vercel 平台,在 /api/* 提供 serverless 函数仿真、自动 TypeScript 编译、应用 vercel.json 的 rewrites/redirects/headers,并从 .env*.local 加载变量;还支持框架检测(Next.js、Nuxt、SvelteKit 等)。

使用方式:用 vercel env pull .env.development.local 拉取 Development 作用域变量;用 vercel dev、vercel dev --listen 8080 或 vercel dev --debug 启动;用 curl 测试 API 路由;对带自身 dev server 的框架改用 npx next dev、npx nuxi dev、npm run dev 或 npx astro dev,vercel dev 仅用于无框架的纯函数项目。环境变量可用 vercel env add/ls/rm 管理。

测试与文件层级:可用 Vitest 模拟请求/响应测试处理函数。环境文件加载顺序为 .env、.env.local、.env.development、.env.development.local,靠后覆盖靠前,其中 .local 文件应被 Git 忽略。

限制:资料只提供设置与用法,未说明收费、价格或平台支持范围;本地函数超 10 秒可能触发 FUNCTION_INVOCATION_TIMEOUT,端口占用会导致 vercel dev 挂起,缺少框架时提示未检测到框架,TypeScript 报错可安装 @vercel/node。