讲师中心 微信公众号
AI工具推荐 视频效率加速

Vite和Mix混用导致CSS 404?一文讲清互斥问题

云明吖_5294

云明吖_5294

发布时间:2026-08-13 15:28:11

|

327人浏览过

|

来源于php中文网

原创

根本原因是Vite与Laravel Mix对CSS中url()路径的重写机制互不兼容:Vite仅处理自身打包的CSS内字面量路径,而Mix生成的CSS文件完全不受Vite影响,导致路径解析基准错乱、资源404。

vite和mix混用导致css 404?一文讲清互斥问题

Vite和Laravel Mix混用时,CSS中url()路径在构建后全部变成404,根本原因是两个工具对静态资源的处理逻辑完全冲突——Mix会把CSS提取到public/css/,而Vite默认把CSS输出到dist/assets/,且各自重写规则互不识别。

为什么Vite和Mix不能共存于同一项目

第一步:确认你是否同时在项目中运行了vite build和npm run dev(Mix默认脚本)。如果vite.config.js存在,且package.json里同时有mix和vite相关命令,就已构成混用事实。

第二步:检查public目录结构。Mix强制将编译产物写入public/css/app.css和public/js/app.js;而Vite默认输出到dist/assets/xxx.css。两者不会合并路径,也不会共享哈希表。

第三步:打开浏览器开发者工具→Network标签页,刷新页面,观察CSS文件请求路径。若看到GET /css/app.css返回404,但GET /assets/app.xxxx.css能成功加载,说明Vite接管了HTML入口但Mix仍在生成冗余CSS——此时两个CSS文件实际都在构建流程中被产出,但只有Vite注入的link标签生效,Mix生成的CSS无人引用却占用了public路径,造成资源错位与404。

立即学习“前端免费学习笔记(深入)”;

关键点在于:【Vite的CSS路径重写机制只作用于它自己解析并打包的CSS内容,对Mix生成的CSS文件完全无感知】。Mix生成的CSS里所有url(../images/logo.png)都按Mix的public目录结构解析,而Vite构建时根本不会去扫描或改写这些外部CSS文件中的路径。

如何判断当前404是Mix还是Vite引发的

方法一:临时禁用Mix,只保留Vite流程

注释掉webpack.mix.js中所有.css()、.postCss()调用,删掉public/css/目录,执行vite build,再检查dist目录下CSS是否含正确哈希路径且背景图可加载。若正常,则原404来自Mix残留产物干扰。

Vite
Vite

为开发、生产构建和库打包配置并优化 Vite。

下载

方法二:临时禁用Vite,只走Mix流程

删除vite.config.js,移除Blade模板中@vite([...])指令,改用<link rel="stylesheet" href="%7B%7B%20mix('css/app.css')%20%7D%7D">,确保mix()辅助函数已启用且mix-manifest.json存在。若此时CSS中图片路径仍404,说明Mix未正确处理url()——Mix默认不重写CSS内联路径,除非你显式配置.copyDirectory('resources/images', 'public/images')并用url('/images/logo.png')引用。

注意:Mix的mix()函数返回404,90%是因为mix-manifest.json未生成或路径映射错误,而非CSS本身路径问题。

彻底解决混用冲突的操作路径

① 删除Mix全部痕迹:运行rm -rf node_modules/.cache/laravel-mix webpack.mix.js mix-manifest.json public/css public/js public/mix-manifest.json

② 清理Blade模板:找到所有{{ mix(...) }}、@mix(...)、<script src="%7B%7B%20mix(...)%20%7D%7D"></script>等调用,全部替换为Vite标准写法@vite(['resources/js/app.js', 'resources/css/app.css'])

③ 迁移资源路径:将原Mix使用的resources/images/下的所有图片,统一移入src/assets/images/;CSS中所有url('../images/logo.png')改为url('./images/logo.png')(必须是相对路径且位于src/assets子目录下)

④ 验证Vite配置:确保vite.config.js中没有误设build.outDir: 'public'——这会让Vite强行覆盖Mix的public输出,引发更混乱的路径冲突。正确做法是保持默认dist,由Web服务器将dist设为根目录,或通过Nginx/Apache重写规则指向dist。

最后一步:执行vite build,打开dist/index.html,检查link标签href是否为/assets/app.xxxx.css,再打开该CSS文件,确认其中所有url()均已转为带hash的绝对路径,如url(/assets/logo.xxxx.png)。

热门AI工具

更多
UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

LibLibAI
LibLibAI Hot

一款AI视频创作工具,主要用于国内领先的AI创意平台,以海量模型、低门槛操作与“创作-分享-商业化”生态,让小白与专业创作者都能高效实现图文乃至视频创意表达,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

相关专题

更多
css
css

css是层叠样式表,用来表现HTML或XML等文件样式的计算机语言,不仅可以静态地修饰网页,还可以配合各种脚本语言动态地对网页各元素进行格式化。php中文网还为大家带来html的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

4076

2023.06.15

css居中
css居中

css居中:1、通过“margin: 0 auto; text-align: center”实现水平居中;2、通过“display:flex”实现水平居中;3、通过“display:table-cell”和“margin-left”实现居中。本专题为大家提供css居中的相关的文章、下载、课程内容,供大家免费下载体验。

897

2023.07.27

css如何插入图片
css如何插入图片

cssCSS是层叠样式表(Cascading Style Sheets)的缩写。它是一种用于描述网页或应用程序外观和样式的标记语言。CSS可以控制网页的字体、颜色、布局、大小、背景、边框等方面,使得网页的外观更加美观和易于阅读。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

1758

2023.07.28

css超出显示...
css超出显示...

在CSS中,当文本内容超出容器的宽度或高度时,可以使用省略号来表示被隐藏的文本内容。本专题为大家提供css超出显示...的相关文章,相关教程,供大家免费体验。

3226

2023.08.01

css字体颜色
css字体颜色

CSS中,字体颜色可以通过属性color来设置,用于控制文本的前景色,字体颜色在网页设计中起到很重要的作用,具有以下表现作用:1、提升可读性;2、强调重点信息;3、营造氛围和美感;4、用于呈现品牌标识或与品牌形象相符的风格。

6385

2023.08.10

什么是css
什么是css

CSS是层叠样式表(Cascading Style Sheets)的缩写,是一种用于描述网页(或其他基于 XML 的文档)样式与布局的标记语言,CSS的作用和意义如下:1、分离样式和内容;2、页面加载速度优化;3、实现响应式设计;4、确保整个网站的风格和样式保持统一。

5431

2023.08.10

css三角形怎么写
css三角形怎么写

CSS可以通过多种方式实现三角形形状,本专题为大家提供css三角形怎么写的相关教程,大家可以免费体验。

1877

2023.08.21

css设置文字颜色
css设置文字颜色

CSS(层叠样式表)可以用于设置文字颜色,这样做有以下好处和优势:1、增加网页的可视化效果;2、突出显示某些重要的信息或关键字;3、增强品牌识别度;4、提高网页的可访问性;5、引起不同的情感共鸣。

2571

2023.08.22

LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

0

2026.09.30

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Sass 教程
Sass 教程

共14课时 | 1.5万人学习

Bootstrap 5教程
Bootstrap 5教程

共46课时 | 5.7万人学习

CSS教程
CSS教程

共754课时 | 95万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn