如何白嫖Vercel部署 VitePress,每个月立省40+元

763 阅读4分钟

如何通过vercel白嫖部署vitepress

vercel 简介

image.png Vercel是一个面向前端开发者的云平台,专为静态和动态网站提供快速部署和托管服务。

它具有以下主要特点:

快速部署:支持将前端应用、静态网站和API快速部署到全球CDN网络

自动化流程:与Git集成,实现代码推送后的自动构建和部署

Serverless架构:提供无服务器功能,简化后端开发和扩展

性能优化:全球CDN、图像优化等功能提升网站性能

易用性:直观的界面和简单的命令行工具,降低使用门槛

免费计划:为个人用户提供免费的基础服务,足以满足大多数个人项目需求

Vercel的设计理念是让开发者专注于代码编写,而无需过多关注服务器管理和部署细节,从而提高开发效率和用户体验

VitePress 简介

image.png

VitePress是一个基于Vite构建的静态站点生成器,专为创建快速、以内容为中心的网站而设计。

作为VuePress的精神继承者,VitePress提供了以下主要特点:

基于Vue 3和Vite,提供更快的开发体验和更好的性能

更轻量级的页面,通过Vue 3的tree-shaking和Rollup代码拆分优化

简化的配置和更灵活的自定义API

内置Markdown扩展,支持代码高亮、表格等高级功能

面向未来的设计,支持原生ES模块和CSS变量

VitePress适用于构建技术文档、博客、个人作品集等各种类型的网站,同时保持了极快的开发和构建速度。

它通过优化静态内容生成和动态内容水合,在保持交互性的同时实现了卓越的性能。

VitePress 应用场景

VitePress作为一个强大而灵活的静态站点生成器,可以用于创建多种类型的网站和文档:

技术文档:VitePress的默认主题专为技术文档设计,支持代码高亮、表格和其他高级功能,非常适合创建API文档、开发指南等。

博客:通过自定义主题和利用VitePress的数据加载API,可以轻松构建个人或团队博客。

个人作品集:利用VitePress的灵活性,可以创建展示个人项目和技能的作品集网站。

营销网站:VitePress支持完全自定义的主题,可以用于构建吸引人的产品或服务营销网站。

知识库:利用VitePress的Markdown支持和搜索功能,可以创建内部或公共知识库系统。

教程网站:VitePress的Vue增强Markdown功能使其非常适合创建交互式教程和学习资源。

VitePress的高性能、简单配置和现代化开发体验使其成为构建各种静态网站的理想选择,特别适合那些需要快速加载和良好SEO的项目。

部署安装

部署到本地

  • 在下面过程中,注意npx vitepress init运行之后,md目录需要放在/docs里.

image.png

  • 本地运行命令
mkdir xvitepress
cd xvitepress
npm add -D vitepress
npx vitepress init
  • 看到结果页面

image.png

部署到Vercel

将VitePress项目部署到Vercel非常简单,只需几个步骤即可完成:

在Vercel仪表板中创建新项目并导入您的VitePress Git仓库

Vercel会自动检测VitePress项目并配置正确的设置

确保构建命令设置为npm run docs:build

输出目录为docs/.vitepress/dist

点击部署按钮,Vercel将自动构建和部署您的网站

Vercel为VitePress项目提供了零配置部署,会自动优化设置以提高性能,如为JavaScript和CSS资源添加"immutable" HTTP缓存头。

每次向主分支推送更改时,Vercel都会自动重新部署您的网站,确保内容始终保持最新。

部署时可能会碰到的问题

  1. 如果你采用npx vitepress init进行安装,请务必把*.md文件的目录放到docs目录下,否则在部署vercel时,你可能会碰到报错:
Error: Command "vitepress build" exited with 127 Error: Check your logs at https://xxxxxx.vercel.app/_logs or run `vercel logs xxxxx.vercel.app`

部署成功的截图示意

image.png