在前端开发中,静态网站(仅含 HTML、CSS、JavaScript,无服务器后端逻辑)是最简单、最轻量的一类项目。Vercel 提供极佳的免费方案,让你可以用极少的成本将静态项目快速部署上线。下面就是一步一步的完整流程与实用建议。
为何选择 Vercel 部署静态站点
- 免费方案即可使用:Vercel 的 Hobby(即免费)计划对个人静态站点足够使用。
- 集成自动化部署:与 GitHub、GitLab 等代码仓库集成,Push 即可触发自动部署。
- 全球 CDN 加速:部署后内容会自动分发至全球节点,访问速度更快。
- HTTPS / SSL 自动配置:无需手动配置证书,Vercel 自动为你搞定。
- 友好界面与开发者体验:操作界面简洁、部署体验顺畅,新手也能快速上手。
正因为这些优势,Vercel 已成为静态站点部署的重要选项之一。
准备静态项目
在开始部署之前,请确保你已有一个静态站点项目结构,大致如下:
my-static-site/
│ index.html
│ about.html
│ css/
│ js/
│ assets/
│ …其他静态资源
如果你使用了静态站点生成器(如 Hugo、Next.js 的静态导出、Gatsby、Eleventy 等),请确保在本地可以成功执行构建命令,并在构建结果文件夹(比如 dist、public 等)中看到最终 HTML / CSS / JS 输出。
创建 Vercel 账号与连接仓库
访问 Vercel 官网并注册账号(可使用 GitHub、GitLab、Email 等方式登录)。
登录后,点击 “New Project” 或 “Import Project” 按钮,授权 Vercel 访问你的代码仓库。
选择你想要部署的仓库(静态站点所在的仓库)。
Vercel 会尝试自动检测项目类型(比如静态、Next.js、Nuxt、Gatsby 等)并给出默认构建设置。你可以确认或调整这些设置。
配置部署设置
在 Vercel 项目设置阶段,你需要关注以下几个关键选项:
- Framework Preset / 项目模板:如果你的项目是纯静态,可以选择静态站点或“Other”类型。
- Build Command / 构建命令:如果项目需要构建(如静态生成器),填入构建命令(如 npm run build、hugo 等)。如果项目不需构建,可以留空或填写 echo 等空操作。
- Output Directory / 输出目录:指定构建产物所在目录(如 dist、public、build 等)。
- Root Directory / 根目录(可选):如果你的静态内容不在项目根目录下(例如在子目录 frontend/),则设置根目录为该子目录。
在确认设置无误后,Vercel 会自动启动一次部署流程。
部署与预览
当你完成上述设置并保存后,Vercel 会拉取你的代码、执行构建、将生成的静态内容发布到其 CDN。几分钟后,你将获得一个预览地址(一般是 .vercel.app 子域名),可以打开它查看你的网站是否正常显示。
接下来,每当你向主分支或指定分支推送更新,Vercel 会自动触发新的部署,你的网站将实时更新。
自定义域名绑定与 HTTPS
要让自己域名生效并启用 HTTPS,请按下面步骤操作:
- 在 Vercel 项目设置中找到「Domains」或「Custom Domain」选项。
- 添加你的域名(例如 www.example.com 或裸域 example.com)。
- 根据提示,在你的域名提供商处添加相应的 DNS 记录(通常是 CNAME 或 A 记录)。
- 等待 DNS 生效后,Vercel 会自动为该域名配置 SSL 证书,你的网站即可通过 HTTPS 访问。
- 这样你的站点将既拥有个性域名也有安全连接。
管理部署环境与分支(可选)
- 预览环境:你可以为非主分支(feature 分支、测试分支)配置预览环境,Vercel 会为每个分支生成独立预览 URL。
- 环境变量:如果你的静态站点在构建时需要一些环境变量(如内容 API Key),可以在 Vercel 仪表板中为项目添加这些变量(在 “Environment Variables” 设置中添加)。
- 自定义构建缓存 / 忽略文件:你可以配置 .vercelignore、vercel.json、ignore 文件等来控制哪些文件不被部署或缓存。
常见问题与优化建议
- 部署失败或构建错误:请检查构建命令是否正确、输出目录是否匹配、项目中是否缺少依赖、以及有没有拼写错误。
- 静态资源路径错误:如果你在 HTML、CSS、JS 中引用资源用了绝对路径(如 /assets/img.png),在子路径或自定义域名下可能访问不到。建议使用相对路径,或者在构建器里配置 basePath 等选项。
- 缓存问题:若更新后仍看到旧内容,可以清除浏览器缓存或强制刷新。Vercel 的 CDN 缓存通常会及时刷新,但某些资源可能仍被客户端缓存。
- 部署时长 / 构建性能:尽量优化构建流程(减少不必要的插件、压缩资源、并行构建等),以缩短部署时间。
- 对免费版的注意事项:在 Vercel 的免费计划中,有构建时间限制、带宽限制、并发部署限制等。对于流量较高或项目较大站点,可能需要考虑升级或其他托管方案。
结语
使用 Vercel 免费部署静态网站是一个快速、简便、高效的方式。它提供自动化部署、全球 CDN 加速、HTTPS 支持和良好开发者体验,让你无需搭建自己的服务器也能拥有稳定可靠的托管平台。按照本文步骤操作,从项目准备、连接仓库、配置构建、上线域名,到持续集成,都能顺利完成。