Post

Vercel等云平台部署Jekyll博客失败原因踩坑总结

可能出现的几个关键报错,如果你也是这种报错,那大概率遇到了和我一样的问题。

1
Error: Command "jekyll build" exited with 1

将构建命令改为jekyll build --trace之后,可能还会出现之类的字眼,如下。

1
/opt/buildhome/.asdf/installs/ruby/3.4.4/lib/ruby/gems/3.4.0/gems/jekyll-4.4.1/lib/jekyll/url.rb:161:in 'String#encode': "\xEF" from ASCII-8BIT to UTF-8 (Encoding::UndefinedConversionError)

第一句话先说结论:个人推测是由于之前某次不小心将文章url设置成了中文,当时的构建工具链的版本允许中文构建,结果后续更新之后不支持了,jekyll试图删除旧文件的过程中扫到了这些url,所以还是会报错,非常恶心。

解决办法是在构建的环境变量里面加入UTF-8的支持,让系统能处理各种语言,不要回推倒ASCII

在个人用的Vercel上是这样设置的

Vercel等云平台部署Jekyll博客踩坑总结-20260102.png

加上两个条目,分别是

Key Value
LANG C.UTF-8
LC_ALL C.UTF-8
This post is licensed under CC BY 4.0 by the author.