Hexo的主题配置

当我们需要美化自己的博客时，可以去hexo官网的主题gallery区域去下载适合自己的主题包，然后按照主题文件的配置说明进行对主题进行配置。主题一般都是放在github上国内访问基本上都很慢，这就没办法了只能慢慢下载或者使用特殊技巧来提高速度。https://hexo.io/themes/ 。这篇博客主要介绍一下在主题配置中遇到的一些麻烦以及解决方法，让主题大神的开源主题能更好地为我们服务。再次感谢各位网友的开源精神。

主题定制

主题下载

我们可以先预览主题网站，觉得不错可以进行下载，下载完成之后，放到我们初始化完成之后的博客文件夹中的theme目录下进行解压。解压完成之后一定要详细阅读对应主题的README.md文档，因为里边有很多需要导入的插件和模块需要执行。下面我们从零开始搭建一个博客，并定制一个主题。

1	$ hexo init test

1
2
3

$ cd test
$ pnpm install
$ pnpm approve-builds

$ cp ../themes/hexo-theme-yilia-plus ./themes/hexo-theme-yilia.zip
$ cd ./themes
$ unzip ./themes/hexo-theme-yilia.zip
$ mv ./hexo-theme-yiliya-plus-master yilia-plus

手动修改test目录下_config.yml中的theme: yilia-plus，这个地方就不再放图了。修改完成之后运行hexo s发现报错，提示缺少chalk模块。首先进行检查系统中是否含有这个模块，没有的话需要使用pnpm进行安装。

$ pnpm list -g --depth=0 | grep -E "(hexo|chalk)"
chalk 5.6.2
hexo-cli 4.3.2
hexo-generator-search 2.4.3
hexo-pagination 4.0.0
hexo-util 4.0.0
hexo-wordcount 6.0.1

电脑中确实已经存在，可能是由于版本依赖的原因。此时就需要强制加入这个模块。

# 进入你的博客目录，例如 cd ~/myblog
$ pnpm add chalk
# 或者，如果明确是开发依赖，可以加 -D
$ pnpm add chalk -D
# 然后进行hexo s
$ hexo s

总结

新主题安装那面会遇到各种问题，我们做一下总结：

务必要仔细阅读README文档，阅读大神们托管在github上的wiki文档。
运行hexo s时遇到的问题提示，如果是依赖类要首先检查系统中是否存在如果存在就加入大概率能解决问题。
如果依赖没有安装，特别是一些博客插件，那就需要重新进行安装可以pnpm cache clear –fore;rm -rf node_modules；然后重新install
还是缺少依赖或者插件，那就进行对应的install或者先去hexo官网找到插件中心搜一下这个插件，确定具体名称然后导入。https://hexo.io/plugins/
如果还是不行就根据报错的提示问问大模型、deepseek、豆包、文心一言等工具来提高效率。