Skip to content

技术选型

信息

框架由Hexo调整为VitePress;
部署由GithubPage调整为Vercel;

1. 为什么选择 VitePress

  1. VitePress侧重技术文档与知识库场景,更能满足个人对技术知识系统化的梳理需求,而Hexo专注于博客,虽然支持标签、分类等基础功能,但不利于构建系统性知识体系;
  2. VitePress采用更现代的技术架构,灵活性更强,其技术栈与实际项目的技术体系一致,能有效降低开发与维护的学习成本。

2. 为什么选择Vercel

  1. Vercel与 Git 仓库深度联动,支持 “推送即部署”,而且配置简单;
  2. Vercel访问速度更快,而Github Page在国内访问时存在严重的网络延迟问题;

3. 快速搭建部署

  1. 在GitHub创建一个新的仓库huanyu-docs,用于存储VitePress项目的代码。
  2. 克隆huanyu-docs仓库到本地,使用VitePress初始化项目:
bash
npm add -D vitepress@next
npx vitepress init
  1. 配置VitePress项目,包括修改config.mjs文件、添加Markdown文档等。
  2. 推送本地代码到GitHub仓库:
  3. 在Vercel上创建一个新的项目,链接到huanyu-docs仓库。
  4. Vercel会自动检测到项目类型为VitePress,并进行配置。
  5. 部署完成后,即可在Vercel上访问到搭建的静态网站。

提示

Vercel项目配置时注意打包命令和输出目录;

4. 域名绑定

  1. 在Vercel项目设置中,找到“Domains”选项,添加域名,添加域名后,Vercel会为该域名分配一个IP地址和CNAME记录。
  2. 在域名服务商管理后台配置DNS记录,将域名指向Vercel分配的IP地址和CNAME记录。
  3. 等待DNS记录生效,即可通过域名访问静态网站,当前可以通过www.aihuanyu.spaceaihuanyu.space访问。

提示

此前域名解析记录中配置的 IP 地址与 CNAME 记录均为固定值,现在需调整为指向 Vercel 平台分配的对应 IP 地址及 CNAME 记录;否则,Vercel 配置页面将显示相关警告提示。