小白搭建Hexo博客(语雀端写作)详细教程
来源：网友推荐 更新：2025-05-21
这篇教程提供了一种从语雀文章更新至Hexo博客自动化同步的方法，包括语雀文章更新、Webhook推送、云函数触发、私有仓库动作拉取更新、部署至公开仓库，实现博客自动更新。此过程既方便了内容的实时同步，也减轻了手动更新的负担。
选择Hexo博客生成器的原因在于，其开发者为台湾同胞，文档等中文支持较好，且社区和主题资源丰富，适合非专业或资深开发者使用。
语雀被选为编辑端，因其在国产在线文档产品中提供了较好的编辑体验，并支持Markdown，方便快速编辑和管理文章。
本教程适合小白、非程序员等用户，对于专业或资深用户，建议选择性阅读。
在搭建Hexo博客前，首先需确保Node.js和Git已安装在电脑上。若已安装，可跳至安装Hexo。
安装Node.js可从官方网站下载安装包完成，或使用包管理器进行安装。
安装Git后，执行安装命令，然后使用以下两种方式（推荐使用第二个）执行Hexo，实现Hexo的安装。
安装完成后，使用命令创建Hexo站点项目文件夹。创建完成后，查看指定文件夹目录，其中包含配置文件、应用程序依赖包信息文件、主题文件夹等。
_config.yml文件是网站配置信息文件，可配置网站名称、主题等参数。package.json文件记录应用程序和依赖包信息。themes文件夹用于存放主题文件，Hexo根据主题生成静态页面。
若对自带的景观主题不满意，可参考官网案例更换其他主题，如Cactus主题。操作步骤包括将新主题克隆到themes文件下，并注意删除克隆完毕后隐藏文件夹.git内的文件，以避免部署到GitHub pages时的仓库冲突问题。
Hexo命令提供了一系列操作，如检查搭建是否成功、配置与调试等，帮助用户完成本地搭建。
安装yuque-hexo插件，使用命令行进行安装，然后根据配置文件添加语雀知识库信息，拉取语雀内容至本地路径，最后执行命令检查是否成功。
解决语雀图片无法显示的问题，需要在主题文件夹下的layout/_partial/head.ejs中添加特定代码，以绕过语雀的防盗链机制。
通过GitHub Actions实现自动更新，包括创建token、配置GitHub Actions文件、设置触发器等步骤。服务器端则使用腾讯云函数服务接收Webhook推送，完成自动更新部署。
验证部署过程，可以使用自己的域名访问已搭建的Hexo博客网站，实现自动化部署与内容更新。
在使用Hexo和Cactus主题时，需要注意一些技巧和坑点，如添加.gitignore文件、设置lastGeneratePath.log文件、修复菜单在Chrome中的消失BUG、增加不蒜子统计等，以优化使用体验。
泉山区唇线：小白搭建Hexo博客(语雀端写作)详细教程
睢品13715894555： 创建GitHub token：在GitHub上创建token，用于自动化更新。配置GitHub Actions：创建并配置GitHub Actions文件，设置触发器。使用腾讯云函数：在服务器端使用腾讯云函数服务接收Webhook推送，完成自动更新部署。验证部署：访问博客网站：使用自己的域名访问已搭建的Hexo博客网站，验证自动化部署与内容更新是否成功。优...
泉山区唇线：小白搭建Hexo博客(语雀端写作)详细教程
睢品13715894555： 验证部署过程，可以使用自己的域名访问已搭建的Hexo博客网站，实现自动化部署与内容更新。在使用Hexo和Cactus主题时，需要注意一些技巧和坑点，如添加.gitignore文件、设置lastGeneratePath.log文件、修复菜单在Chrome中的消失BUG、增加不蒜子统计等，以优化使用体验。
泉山区唇线：使用「语雀」搭建个人博客
睢品13715894555： 本人从事程序开发工作，之前使用hexo框架通过git搭建过个人网站。搭建过程中光是查资料、改网站页面、配置各种样式等等都费了很多功夫，就更别提非电脑专业人士搭建起来有多困难了。 如果你不想折腾，只想快速拥有一个属于自己的博客网站，并专注内容创作，那「语雀」将是一个非常合适的选择 。 「语雀」的...
选择Hexo博客生成器的原因在于，其开发者为台湾同胞，文档等中文支持较好，且社区和主题资源丰富，适合非专业或资深开发者使用。
语雀被选为编辑端，因其在国产在线文档产品中提供了较好的编辑体验，并支持Markdown，方便快速编辑和管理文章。
本教程适合小白、非程序员等用户，对于专业或资深用户，建议选择性阅读。
在搭建Hexo博客前，首先需确保Node.js和Git已安装在电脑上。若已安装，可跳至安装Hexo。
安装Node.js可从官方网站下载安装包完成，或使用包管理器进行安装。
安装Git后，执行安装命令，然后使用以下两种方式（推荐使用第二个）执行Hexo，实现Hexo的安装。
安装完成后，使用命令创建Hexo站点项目文件夹。创建完成后，查看指定文件夹目录，其中包含配置文件、应用程序依赖包信息文件、主题文件夹等。
_config.yml文件是网站配置信息文件，可配置网站名称、主题等参数。package.json文件记录应用程序和依赖包信息。themes文件夹用于存放主题文件，Hexo根据主题生成静态页面。
若对自带的景观主题不满意，可参考官网案例更换其他主题，如Cactus主题。操作步骤包括将新主题克隆到themes文件下，并注意删除克隆完毕后隐藏文件夹.git内的文件，以避免部署到GitHub pages时的仓库冲突问题。
Hexo命令提供了一系列操作，如检查搭建是否成功、配置与调试等，帮助用户完成本地搭建。
安装yuque-hexo插件，使用命令行进行安装，然后根据配置文件添加语雀知识库信息，拉取语雀内容至本地路径，最后执行命令检查是否成功。
解决语雀图片无法显示的问题，需要在主题文件夹下的layout/_partial/head.ejs中添加特定代码，以绕过语雀的防盗链机制。
通过GitHub Actions实现自动更新，包括创建token、配置GitHub Actions文件、设置触发器等步骤。服务器端则使用腾讯云函数服务接收Webhook推送，完成自动更新部署。
验证部署过程，可以使用自己的域名访问已搭建的Hexo博客网站，实现自动化部署与内容更新。
在使用Hexo和Cactus主题时，需要注意一些技巧和坑点，如添加.gitignore文件、设置lastGeneratePath.log文件、修复菜单在Chrome中的消失BUG、增加不蒜子统计等，以优化使用体验。
睢品13715894555： 创建GitHub token：在GitHub上创建token，用于自动化更新。配置GitHub Actions：创建并配置GitHub Actions文件，设置触发器。使用腾讯云函数：在服务器端使用腾讯云函数服务接收Webhook推送，完成自动更新部署。验证部署：访问博客网站：使用自己的域名访问已搭建的Hexo博客网站，验证自动化部署与内容更新是否成功。优...
睢品13715894555： 验证部署过程，可以使用自己的域名访问已搭建的Hexo博客网站，实现自动化部署与内容更新。在使用Hexo和Cactus主题时，需要注意一些技巧和坑点，如添加.gitignore文件、设置lastGeneratePath.log文件、修复菜单在Chrome中的消失BUG、增加不蒜子统计等，以优化使用体验。
睢品13715894555： 本人从事程序开发工作，之前使用hexo框架通过git搭建过个人网站。搭建过程中光是查资料、改网站页面、配置各种样式等等都费了很多功夫，就更别提非电脑专业人士搭建起来有多困难了。 如果你不想折腾，只想快速拥有一个属于自己的博客网站，并专注内容创作，那「语雀」将是一个非常合适的选择 。 「语雀」的...
