技术选型
信息
框架由Hexo调整为VitePress;
部署由GithubPage调整为Vercel;
1. 为什么选择 VitePress
- VitePress侧重技术文档与知识库场景,更能满足个人对技术知识系统化的梳理需求,而Hexo专注于博客,虽然支持标签、分类等基础功能,但不利于构建系统性知识体系;
- VitePress采用更现代的技术架构,灵活性更强,其技术栈与实际项目的技术体系一致,能有效降低开发与维护的学习成本。
2. 为什么选择Vercel
- Vercel与 Git 仓库深度联动,支持 “推送即部署”,而且配置简单;
- Vercel访问速度更快,而Github Page在国内访问时存在严重的网络延迟问题;
3. 快速搭建部署
- 在GitHub创建一个新的仓库huanyu-docs,用于存储VitePress项目的代码。
- 克隆huanyu-docs仓库到本地,使用VitePress初始化项目:
bash
npm add -D vitepress@next
npx vitepress init
- 配置VitePress项目,包括修改config.mjs文件、添加Markdown文档等。
- 推送本地代码到GitHub仓库:
- 在Vercel上创建一个新的项目,链接到huanyu-docs仓库。
- Vercel会自动检测到项目类型为VitePress,并进行配置。
- 部署完成后,即可在Vercel上访问到搭建的静态网站。
提示
Vercel项目配置时注意打包命令和输出目录;
4. 域名绑定
- 在Vercel项目设置中,找到“Domains”选项,添加域名,添加域名后,Vercel会为该域名分配一个IP地址和CNAME记录。
- 在域名服务商管理后台配置DNS记录,将域名指向Vercel分配的IP地址和CNAME记录。
- 等待DNS记录生效,即可通过域名访问静态网站,当前可以通过
www.aihuanyu.space
和aihuanyu.space
访问。
提示
此前域名解析记录中配置的 IP 地址与 CNAME 记录均为固定值,现在需调整为指向 Vercel 平台分配的对应 IP 地址及 CNAME 记录;否则,Vercel 配置页面将显示相关警告提示。