大家好,我是二哥呀!真没想到,有一天,自己也能把自己的在线网站《Java 程序员进阶之路》给搞挂了!
就因为干了两件事。
第一件,执行 yarn add -D vuepress-theme-hope@next
命令对该主题进行升级。
第二件,执行 git pull
从 GitHub 远程仓库拉取最新文档到服务器。
然后,当我执行 yarn docs:build
重新构建网站内容的时候就构建失败了!
满屏满屏的错误,真把我着急坏了!日志看又看不懂,毕竟作为一名只会 CURD 的后端程序员,前端 VuePress 工作的原理我也不是很熟。
构建失败就意味着我的网站暂时访问不了了,要知道《Java 程序员进阶之路》 vuepress 版虽然上线没几天,但每天也有好多好多好多小伙伴访问呢!
用一个字形容我此刻的心情,就是“如坐针毡”(对,真一个字)!
虽然情绪很崩溃,但还是得冷静下来,想想该怎么解决问题。
第一个尝试,删除临时目录,重新安装 vuepress-theme-hope 主题,再次构建。
竟然失败了!
我又尝试删除配置文件 package.json,重新安装 VuePress 重新构建,等等,均告失败!
菜,真菜,此刻我只好躲在角落里偷偷抹眼泪。是不是像极了你平常工作/学习时遇到 bug 解决不了的样子?
那只能上最后的杀手锏了,重新初始化 vuepress-theme-hope 主题!
这让我想起刚参加工作的时候,本地遇到环境问题,一定会上重启三连,重启 Tomcat,重启 Eclipse,重启电脑。当然了,生产环境遇到问题,可就不敢随意重启了。
重启大法就是好呀!
不过,重新初始化后,vuepress-theme-hope 主题会生成新的 demo 文档,并且会覆盖 Git 仓库本地的内容。
于是我就灵机一动,先删除 docs 目录再使用 git pull
从远程仓库拉取最新内容覆盖本地仓库不就完事了吗?
结果又出意外了,docs 目录竟然没同步下来,我天真了!
应该直接使用 git revert HEAD
命令直接强制恢复本地仓库到最新远程仓库的版本才对。
vuepress-theme-hope 主题环境重置了,文档内容也重置了,接下来需要做的就是重新构建,再次执行 yarn docs:build
,稍等片刻(VuePress 的构建过程是真的有点慢,差不多需要 1 分多钟),发现构建成功了!
访问 https://tobebetterjavaer.com
,发现《Java 程序员进阶之路》终于又可以访问了!
简单总结下:
- 当我们遇到问题时,一定不要慌,先看日志;
- 当日志看不懂的时候,不是自己熟悉的领域时,先尝试通过经验去解决问题;像这种 VuePress 环境问题,大不了重新初始化就行了,肯定能解决;
- 一定要充分利用 GitHub 仓库,毕竟免费;
- 一定要熟练使用 Git,可以防止版本丢失。
后续《Java 程序员进阶之路》还要升级好多内容,比如说内容搜索 DocSearch,难免后续会再次遇到构建问题,所以必须得记录一波,免得下次又忘记了该怎么修复。
很多网站都用了 DocSearch 做为搜索,比如说我现在使用的 vuepress-theme-hope!好家伙,刚去官网查看项目案例,竟然发现了二哥的小破站也光荣在榜