vuepress项目部署出现样式丢失,图片加载失败的问题

本文介绍了一次Vuepress项目部署过程中遇到的样式丢失问题及解决方法。问题在于资源路径配置错误,通过调整base字段为相对路径解决了样式和资源加载失败的情况。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

之前在尝试部署vuepress项目时,出现了样式丢失,图片加载失败的问题。具体情况请继续往下看:

本地测试 —— 完全正常

在本地测试时的样式都是正常显示的:

在这里插入图片描述

GitHub部署 —— 样式丢失

打包部署到GitHub上时,布局和样式就完全乱了:

在这里插入图片描述


同时还有一堆报错 —— 基本都是资源加载失败:


在这里插入图片描述
思考一下,我们最终部署到GitHub上的项目文件是本地打包好的dist文件,推测可能是本地打包出问题了。再来看看dist/index.html文件:

本地打包dist文件 —— 样式丢失

果然本地打包出的项目文件就有问题,样式同样丢失了:

在这里插入图片描述


解决方案

资源加载失败,基本都是路径出了问题。查看dist/index.html文件可以看到,资源路径都写的是根目录下 /

在这里插入图片描述
这里的根目录 / 路径是我们之前在/docs/.vuepress/config.js中配置的base字段:

在这里插入图片描述
这里的资源路径不应该是绝对路径 —— 根目录 / ,而应该是相对路径 ./ ,从我们打包出来的文件路径查找。

因为我们最终上传部署的是构建打包出来的文件,所以你这里的资源加载路径写绝对路径(本地根目录 / )肯定是找不到的呀。应该是以构建打包出的文件为主,直接使用相对路径即可。

修改base字段为 ./ 后,重新打包上传部署,可以看到就显示正常啦~

在这里插入图片描述


本地测试时常使用绝对路径,但是部署时都应该使用相对路径。这也算是一个小的经验吧!

评论 9
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值