目录

Vercel 使用教程

Vercel 是一个前端 / 静态站点托管平台:把本地的一堆文件(或一个前端项目)传上去,它替你跑构建、发到全球 CDN,最后给你一个能直接访问的 https 网址。

Next.js笔记 里提到过它,这篇专门讲怎么用,重点放在不接 Git 仓库的做法——直接把自己电脑上的代码传上去建站。

一、三种部署方式怎么选

方式 操作 需要的条件
Git 集成 绑定 GitHub / GitLab / Bitbucket,push 后自动部署 需要仓库,需要 Git
网页上传 在控制台里拖入文件夹或 zip 什么都不用装
CLI 命令 在本地命令行部署,可脚本化 装 Node.js(推荐)

关键认识:不用 Git 完全不影响功能。三种方式产出的结果一模一样,都会得到一个 项目名.vercel.app 的网址,区别只在于“代码怎么送到 Vercel”和“以后怎么更新”。

二、准备工作

  1. 注册账号:vercel.com/signup。用邮箱注册即可,不必绑 Git;当然也能用 GitHub / Google 账号登录(那只是身份认证,不代表要用它托管代码)。
  2. 整理本地目录,让网站根目录清晰。纯静态站点长这样:
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 的话,控制台本身就带上传部署入口:

  1. 打开 vercel.com/new,或者在已有项目的 Deployments 页面找右上角的部署按钮(不同时期文案可能是 Create Deployment 或 Deploy,认准带虚线上传框的弹窗;UI 会变,以实际界面为准)。
  2. 把 index.html 所在的整个文件夹拖进去,或者选择一个提前打好的 zip 包;还没有项目时会引导你先建一个。
  3. 等它跑完,页面给出 项目名.vercel.app 网址。

三点提醒:

五、绑定自己的域名

  1. 控制台进入项目 → Settings → Domains → Add,填域名(建议 example.com 和 www.example.com 都加上)。
  2. 按面板提示到域名服务商添加解析,以面板显示的值优先;常见组合是: * 裸域 example.com:A 记录 → 76.76.21.21 * www:CNAME → cname.vercel-dns.com
  3. 也可以把域名的 NS 直接托管给 Vercel,由它统一管解析。
  4. HTTPS 证书自动签发、自动续期,不用自己配。

解析生效一般几分钟到几小时。如果域名套了 Cloudflare,先关掉橙色云朵(代理)能避免校验失败。

六、更新与回滚

常用命令:

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" }
      ]
    }
  ]
}

注意:Git 集成部署时 vercel.json 必须提交进仓库才生效;CLI 上传时它待在本地目录里就够了。

八、.vercelignore

语法跟 .gitignore 一样,用来排除不上传的文件,能明显加快上传:

snippet.text
node_modules
.env
*.log
/draft

依赖目录一般会被自动忽略,显式写一份更保险。环境变量务必用 vercel env add 管理,不要写进源码。

九、常见坑

十、最小可用流程回顾

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 直接发给浏览器,服务端不执行任何逻辑。 但只要出现下面这些需求,就必须有代码在服务器上跑:

函数(Functions)就是干这个的:跑在 Vercel 云上的后端代码。 你不用买服务器、不用配 Nginx,写一个文件传上去就是一个接口。

1. 三个关键概念

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. 容易被忽略的点

十二、账单、发票与报销

结论先行:能不能报销,取决于两件事——你是不是付费用户,以及你公司财务认不认英文 Invoice。

1. 免费用户没有发票

Hobby 计划不产生任何费用,自然没有发票或收据,也就无所谓报销。要开票,前提是先升级到 Pro。

2. 付费用户在哪里拿账单

(Vercel 的界面文案会调整,具体菜单名以你登录后看到的 Billing 页面为准。)

3. 国内报销的现实问题

下面几条是经验判断,务必先跟财务确认:

4. 一句话总结

个人练手用 Hobby,不用关心发票;公司项目要报销,先问财务能不能收英文 Invoice,再决定要不要升级 Pro。

参考资料:Vercel 官网、官方文档、CLI 文档、Functions 文档、价格与账单文档