507 字
3 分钟
hexo安装问题指北
2025-05-05

安装#

前期准备#

  1. Node.js

  2. Git

  3. Github Desktop (如果需要比较方便上传到GitHub上)

  4. hexo

    安装命令官网是有点,这里放一下

npm install hexo-cli -g
hexo init blog #这里blog可以改成你喜欢的文件夹名,注意在你想创建博客的文件夹里执行
cd blog
npm install
hexo server #启动服务,可缩写为hexo s,注意按住curl点击终端里显示的链接进入网页

主题#

找到你喜欢的主题后,查看它的安装教程,一般在GitHub页上有,以diaspora主题示例:

安装主题#

在你网站根目录里打开themes,右键打开终端,输入

git clone https://github.com/Fechin/hexo-theme-diaspora.git themes/diaspora

启动主题#

修改Hexo配置文件 _config.yml(在网站根目录) 主题项设置为diaspora(最下面)

...
theme: diaspora
...

配置#

在主题文件夹(themes)里有文档(README.md)给出了很详细的配置方法了,这里只写些可能遇到的问题:

  • 背景图等图片文件路径

    主题文件夹下source的img里

  • 写文章

    用支持Markdown语法的编辑器写在网站根目录下source的_posts里,比如Typora

  • 发布后点首页图标跳转到其他地方

    根目录下配置文件(_config.yml)里更改url那一段,实在不会复制全部配置问AI怎么改

  • 搜索不可用

    安装搜索插件命令: npm install hexo-generator-searchdb —save

    然后跟着redme文件做就行,注意可能没安装上搜索查找,多安装几次

发布#

可以参考这个教程来做,如果是上传到自己的服务器上可以在服务器上安装个宝塔面板来部署。

打包成静态网页大致流程:

hexo clean #清除曾经生成的静态网页

hexo g #构建静态网页

在根目录下的public文件夹里,里面的所有文件就是你要发布的静态网页

OK了

如果遇到网页打开缓慢可以尝试压缩图片大小解决