出海独角兽
Vercel 部署这篇,我只能先写一份待实测清单
原手册只有登录和三行提纲,没有部署结果。这篇据官方文档整理待实测清单,不冒充已经 Ready。

我原来的手册里,Vercel 一共只有两处记录。
前面写 Vercel 对 Next.js 支持好,文档和模板多,打开官网并登录。后面列了三项提纲,分别是从 GitHub 拉代码部署、配置环境变量和密钥、根据日志排错。
原记录没有导入仓库截图和 Deployment 页面,更找不到 Ready 状态或可访问的 Preview 地址。用这些材料写成“我已经把项目部署成功”,就是把提纲冒充实操。
所以这篇先换一个位置,写成我下一次实测要逐项留证的清单。以下步骤来自 Vercel 当前官方文档,不代表我已经执行。
先别急着写成功。
第一关,Git 仓库能否真正触发部署
Vercel 当前支持连接 GitHub、GitLab、Bitbucket 和 Azure DevOps。仓库连接后,分支推送和 Pull Request 可以触发部署;生产分支对应 Production,其余分支通常对应 Preview,这些状态需要在同一次实测中留下页面证据。
我实测时不会只截“已登录”。至少要留下导入的仓库、项目 Root Directory、框架与构建配置,以及第一次部署最终停在哪个状态。
这里还有一个前置条件。代码必须真的在远端 Git 仓库里。本地 GitHub Desktop 出现 Commit,不等于 Vercel 已经能拉到代码。
第二关,环境变量属于哪个环境
原手册只写了“环境变量 & 密钥管理”,没有任何字段或结果。
Vercel 官方文档把变量分到 Production、Preview、Development 和自定义环境。变量新增或修改后,只会作用于之后的新部署,不会自动改写已经完成的部署。
实测时要记录两件事。变量加到了哪个环境,加完以后是否重新部署。密钥值本身不能出现在截图、文章或日志里。
第三关,失败时去哪里看日志
“线上排错思路,日志”也只是原文标题。当前 Vercel 文档提供 Deployment Logs、Runtime Logs 等入口,用来查看构建和运行阶段发生了什么。
实测证据应该包括失败阶段、日志中的第一条有效错误、改动内容和重新部署后的状态。只贴一张红色报错页,没有完整排错过程,也不能叫完成。
什么结果才允许我把这篇改成实操
- GitHub 远端仓库存在目标提交。
- Vercel 项目绑定正确的仓库、分支和 Root Directory。
- 构建过程有可核对的 Deployment Logs。
- 需要的变量已放进正确环境,并在新部署中生效。
- Preview URL 能打开目标页面。
- 最终状态、地址和页面来自同一次部署。
在这些证据补齐前,我不会写“部署完成”“Ready”或“Preview 已验收”。现在只能确认我当时选了 Vercel,并记下部署、环境变量、日志三块待办。
官方资料
如果你也在做 AI 出海、独立开发或海外业务,欢迎关注「出海独角兽🦄」。
这里继续分享工具、收款、增长和运营里能直接照着做的步骤。