Vercel 使用教程
Vercel 是一个前端 / 静态站点托管平台:把本地的一堆文件(或一个前端项目)传上去,它替你跑构建、发到全球 CDN,最后给你一个能直接访问的 https 网址。
Next.js笔记 里提到过它,这篇专门讲怎么用,重点放在不接 Git 仓库的做法——直接把自己电脑上的代码传上去建站。
一、三种部署方式怎么选
| 方式 | 操作 | 需要的条件 |
|---|---|---|
| Git 集成 | 绑定 GitHub / GitLab / Bitbucket,push 后自动部署 | 需要仓库,需要 Git |
| 网页上传 | 在控制台里拖入文件夹或 zip | 什么都不用装 |
| CLI 命令 | 在本地命令行部署,可脚本化 | 装 Node.js(推荐) |
关键认识:不用 Git 完全不影响功能。三种方式产出的结果一模一样,都会得到一个 项目名.vercel.app 的网址,区别只在于“代码怎么送到 Vercel”和“以后怎么更新”。
二、准备工作
- 注册账号:vercel.com/signup。用邮箱注册即可,不必绑 Git;当然也能用 GitHub / Google 账号登录(那只是身份认证,不代表要用它托管代码)。
- 整理本地目录,让网站根目录清晰。纯静态站点长这样:
- snippet.text
my-site/ ├── index.html ← 入口,必须在最外层 ├── style.css ├── app.js └── images/ └── logo.png
需要构建的项目(Vite / React / Next 等),保证 package.json 在项目根目录即可。
三、方案一:CLI 上传(推荐)
1. 安装 Node.js 与 CLI
- snippet.bash
node -v # 确认 Node 18+(新版本 CLI 要求更高,建议 20+) npm i -g vercel vercel --version
Windows 下若提示权限不足,用管理员身份打开 PowerShell 重试。
2. 登录
- snippet.bash
vercel login
会让你选择登录方式(邮箱 / GitHub / Google)。选邮箱时,命令行给出一个确认地址,用浏览器打开点确认即可(设备授权流程),全程不涉及 Git。
3. 在项目目录里部署
- snippet.bash
cd my-site vercel # 部署到 Preview(预览环境),先验证效果 vercel --prod # 部署到 Production(正式网址) vercel --yes # 想跳过全部交互、一律用默认值时可加这个参数
首次运行会问几个问题,答完写入 .vercel/ 目录,以后就不会重复问:
- snippet.text
? Set up and deploy "~/my-site"? Y ? Which scope do you want to deploy to? 选自己的账号 ? Link to existing project? N ? What's your project's name? my-site ? In which directory is your code located? ./ ? Want to modify these build settings? N
需要构建的项目:Vercel 会自动识别 Vite / Next / Nuxt 等框架,用默认构建命令和默认输出目录在云端构建,所以你不需要先在本地构建。识别错了就在上面那步选 Y 手动填 Build Command 与 Output Directory,或者事后到控制台 Settings → Build & Development Settings 修改。
纯静态项目(没有 package.json、只有 index.html):Vercel 直接当静态站点托管,不跑任何构建。
4. 更新网站
改完代码,再执行一次生产部署那条命令就行。每次部署都是一份不可变快照,旧版本不会丢。
5. 不想把源码传到云端
默认行为是上传源码、由 Vercel 云端构建。只想传成品的话:
- snippet.bash
vercel pull --yes --environment=production # 拉取项目配置与环境变量 vercel build --prod # 本地构建,产物在 .vercel/output vercel deploy --prebuilt --prod # 只上传构建产物
这样 Vercel 拿到的是结果文件,拿不到源码。
四、方案二:网页上传(零安装)
不想装 Node.js 的话,控制台本身就带上传部署入口:
- 打开 vercel.com/new,或者在已有项目的 Deployments 页面找右上角的部署按钮(不同时期文案可能是
Create Deployment或Deploy,认准带虚线上传框的弹窗;UI 会变,以实际界面为准)。 - 把
index.html所在的整个文件夹拖进去,或者选择一个提前打好的 zip 包;还没有项目时会引导你先建一个。 - 等它跑完,页面给出
项目名.vercel.app网址。
三点提醒:
- 拖的是“网站根目录本身”,不要把外层文件夹一起打包,否则会多出一层路径。
- 项目需要构建时,先在本地构建好、拖产物目录最稳妥;想省心就直接用 CLI 让云端构建。
- 上传有体积上限,大项目会被拒绝,这时必须改用 CLI。
五、绑定自己的域名
- 控制台进入项目 → Settings → Domains → Add,填域名(建议
example.com和www.example.com都加上)。 - 按面板提示到域名服务商添加解析,以面板显示的值优先;常见组合是: * 裸域
example.com:A 记录 →76.76.21.21*www:CNAME →cname.vercel-dns.com - 也可以把域名的 NS 直接托管给 Vercel,由它统一管解析。
- HTTPS 证书自动签发、自动续期,不用自己配。
解析生效一般几分钟到几小时。如果域名套了 Cloudflare,先关掉橙色云朵(代理)能避免校验失败。
六、更新与回滚
- 更新:重跑 CLI,或重新拖拽上传,产生一个新部署。
- 回滚:控制台 → Deployments → 找到旧部署 → 右侧点更多菜单 → Promote to Production,秒级切回,不用重新构建。
常用命令:
- snippet.bash
vercel ls # 列出本项目的历史部署 vercel inspect <url> # 查看某次部署详情(产物、函数、耗时) vercel logs <url> # 查看运行时日志 vercel rm <url> # 删除某次部署 vercel env add MY_KEY # 添加环境变量(生产 / 预览 / 开发 分环境) vercel dev # 本地起一个接近线上的开发环境 vercel domains ls # 查看已绑定域名
七、vercel.json:静态站点最常用的配置
纯静态站点通常不需要它,需要下面几件事时再加:
- snippet.json
{ "cleanUrls": true, "trailingSlash": false, "rewrites": [ { "source": "/(.*)", "destination": "/index.html" } ], "headers": [ { "source": "/(.*)", "headers": [ { "key": "X-Content-Type-Options", "value": "nosniff" }, { "key": "X-Frame-Options", "value": "SAMEORIGIN" }, { "key": "Referrer-Policy", "value": "strict-origin-when-cross-origin" } ] } ] }
cleanUrls:访问/about也能命中about.html。rewrites:单页应用(SPA)刷新不 404 的经典做法——找不到的路径统一回退到index.html。静态文件优先于 rewrites 生效,所以 CSS / JS 不会被误改写。headers:统一注入安全头,省得每页单独写,可参考 安全头。
注意:Git 集成部署时 vercel.json 必须提交进仓库才生效;CLI 上传时它待在本地目录里就够了。
八、.vercelignore
语法跟 .gitignore 一样,用来排除不上传的文件,能明显加快上传:
- snippet.text
node_modules .env *.log /draft
依赖目录一般会被自动忽略,显式写一份更保险。环境变量务必用 vercel env add 管理,不要写进源码。
九、常见坑
- 根目录没有
index.html:访问根路径直接 404。上传的必须是“网站根目录”,不是它的上一级。 - 文件名大小写:Windows / macOS 默认不区分大小写,Vercel 的 Linux 构建环境区分。
Logo.PNG引用成logo.png,本地正常、线上 404。 - 绝对路径:部署在域名根下,写
/style.css没问题;若要挂到子路径,改用相对路径或设置 base。 - SPA 刷新 404:见第七节的
rewrites。 - 免费(Hobby)计划限个人非商业用途,商业项目按条款需升级 Pro;且 Hobby 的函数区域固定、无法自选,国内访问延迟偏高。
- 国内网络体验:Vercel 默认域名在国内不稳定,纯展示站可以接受;面向国内用户的服务建议同时准备国内节点或 CDN 方案。
- 拖拽上传有体积上限,大项目走 CLI。
- 预览和正式是两套地址:只跑
vercel得到的是预览地址,别把它当正式站发出去。
十、最小可用流程回顾
- snippet.text
1. 邮箱注册 Vercel 账号(不需要 Git) 2. 本地准备好文件夹,根目录放 index.html 3. npm i -g vercel → vercel login 4. 在项目目录里执行: vercel --prod 5. 拿到 xxx.vercel.app,用浏览器验证页面 6. 需要独立域名:项目 → Settings → Domains 7. 以后要更新:再执行一次 vercel --prod
十一、Vercel 函数(Functions)是什么
前面十节讲的都是静态托管:把 HTML / CSS / JS 直接发给浏览器,服务端不执行任何逻辑。 但只要出现下面这些需求,就必须有代码在服务器上跑:
- 表单提交后要写数据库、发邮件
- 接收第三方平台的 Webhook 回调
- 调用需要密钥的第三方 API(例如大模型接口),而密钥不能出现在前端 JS 里
函数(Functions)就是干这个的:跑在 Vercel 云上的后端代码。 你不用买服务器、不用配 Nginx,写一个文件传上去就是一个接口。
1. 三个关键概念
- 位置即路由:函数文件放在项目根的
api/目录,一个文件 = 一个接口。api/hello.js对应的地址就是项目名.vercel.app/api/hello。 - 按请求唤起:平时没有常驻进程,只有请求打到这个地址时才被唤起,跑完就休眠。所以计费方式是调用次数 + 执行时长,免费额度用不完就不花钱。这就是 Serverless(无服务器)的含义——不是真的没有服务器,而是你不用管服务器。
- 和静态页面不冲突:同一个项目里,
index.html、CSS、图片照样走 CDN 静态分发,只有/api/*的请求才会去执行函数。
2. 写法(Node.js 运行时)
- snippet.js
// api/hello.js export default function handler(request, response) { response.status(200).json({ ok: true, time: Date.now() }); }
部署后浏览器直接打开 /api/hello,就能看到返回的 JSON。
(若项目是 CommonJS,也可以用 module.exports = (req, res) ⇒ {…} 的写法。)
3. 两种运行时怎么选
| 运行时 | 特点 | 适合的场景 |
|---|---|---|
| Node.js Functions | 默认,能用完整的 Node 生态和 npm 包 | 读写数据库、发邮件、复杂业务逻辑 |
| Edge Functions | 跑在全球边缘节点,基于 Web 标准 Request / Response,冷启动更快 | 鉴权、重定向、A/B 测试等轻量逻辑 |
Edge 只提供有限的 Web API,用不了大部分 Node 模块,别把依赖 Node 原生模块的代码往 Edge 上搬。
4. 容易被忽略的点
- Next.js 里的服务端渲染、Route Handlers 本质上也是 Functions,只是由框架自动生成,不需要你手写
api/目录。 - 冷启动:闲置一段时间后第一次访问会稍慢(Edge 明显更快)。
- 执行时长有上限,长任务不适合放在函数里;具体上限随计划不同,以官方文档为准。
- 函数不保存状态:每次调用都可能是全新实例,会话 / 计数要放数据库或 KV。
- 免费 Hobby 计划的函数区域固定,国内访问延迟偏高。
- 本地调试:
vercel dev会在本机起一个接近线上的环境。
十二、账单、发票与报销
结论先行:能不能报销,取决于两件事——你是不是付费用户,以及你公司财务认不认英文 Invoice。
1. 免费用户没有发票
Hobby 计划不产生任何费用,自然没有发票或收据,也就无所谓报销。要开票,前提是先升级到 Pro。
2. 付费用户在哪里拿账单
- 控制台进入团队 → Settings → Billing,在账单 / Invoices 历史里可以下载每期的 Invoice / Receipt(PDF)。
- 付款成功后,账单一般也会发送到账号邮箱。
- 同一处可以填写公司名、账单地址、VAT / 税号,填好之后生成的 Invoice 才会带上这些信息——建议在订阅之前就填好,否则已开出的账单信息不好补。
(Vercel 的界面文案会调整,具体菜单名以你登录后看到的 Billing 页面为准。)
3. 国内报销的现实问题
下面几条是经验判断,务必先跟财务确认:
- Vercel 是海外公司,出具的是英文 Invoice / Receipt,不是中国的增值税专用发票或普通发票,国内多数公司的财务不认,也无法作为企业所得税税前扣除凭证。
- 常见变通:把信用卡账单 / 银行支付流水和英文 Invoice 一起提交,请财务按“境外服务费”处理;金额较小时,有些公司走费用报销流程能直接通过。
- 若有香港或海外公司主体,通常可以直接把英文 Invoice 入账。
- 报销实在走不通时,替代思路是换用国内可开票的托管平台,或把域名、CDN 交给国内厂商,Vercel 只留开发预览。
4. 一句话总结
个人练手用 Hobby,不用关心发票;公司项目要报销,先问财务能不能收英文 Invoice,再决定要不要升级 Pro。