关键是要确认构建工具输出配置与laravel读取机制:mix产物直出public/子目录并依赖mix-manifest.json映射;vite默认输出public/build/,生产时靠manifest.json将resources/路径映射为带hash的assets路径,且@vite必须匹配vite.config.js中build.outdir与config/vite.php中'build_directory'。

要看编译后文件实际放在哪,关键不是“找路径”,而是确认构建工具的输出配置和 Laravel 如何读取它——Mix 和 Vite 完全不同,不能套用同一套逻辑。
查看 Laravel Mix 编译后的文件路径
Mix 把产物直接写进 public/ 下你指定的子目录,路径由 webpack.mix.js 中的第二个参数决定:
-
mix.js('resources/js/app.js', 'public/js')→ 输出到public/js/app.js -
mix.postcss('resources/css/app.css', 'public/css')→ 输出到public/css/app.css - 如果用了版本控制(
.version()),会生成public/mix-manifest.json,里面记录了带哈希的真实文件名,例如:{"/js/app.js": "/js/app.js?id=abc123"}
Blade 中用 {{ mix('js/app.js') }} 就是去读这个 manifest 文件,再拼出最终 URL。所以查路径,先看 mix-manifest.json 内容,再对照 public 目录下是否真有对应文件。
查看 Vite 编译后的文件路径
Vite 默认输出到 public/build/,但真实路径取决于 vite.config.js 的 build.outDir 配置:
- 默认值是
'public/build',运行vite build后,你会看到:
•public/build/manifest.json(必须存在)
•public/build/assets/app.xxxx.js
•public/build/assets/app.xxxx.css - manifest.json 里 key 是源路径(如
"resources/js/app.js"),value 是带 hash 的产物路径(如"assets/app.xxxx.js") - Laravel 的
@vite(['resources/js/app.js'])就是靠这个 JSON 映射出最终链接,比如变成/build/assets/app.xxxx.js
如果你改过 outDir(比如设成 'public/assets'),那 manifest.json 也要在 public/assets/ 下,并且需同步在 config/vite.php 中设置 'build_directory' => 'assets',否则 @vite 找不到。
为什么浏览器 Network 面板看到的路径和你预期不一样?
这不是“路径错了”,而是构建工具和 Laravel 协作机制在起作用:
- Mix:只要
mix-manifest.json存在且格式正确,mix()函数就按它返回路径;删掉这个文件,就会退回到未哈希的原始路径(比如/js/app.js) - Vite:
@vite在开发时请求的是http://localhost:5173/@vite/client等 HMR 脚本;生产时才查manifest.json—— 如果页面白屏或报 404,第一反应不是代码问题,而是检查public/build/manifest.json是否生成、是否上传、JSON 是否合法 - 注意:Vite 不处理
public/下直接放的图片或字体,那些路径(如/images/logo.png)不会进 manifest,也不会被重命名,@vite 完全不感知
快速验证路径是否生效的实操方法
- 执行构建命令后,立刻打开终端运行:
ls -la public/build/(Vite)或cat public/mix-manifest.json(Mix) - 在浏览器打开页面,右键「查看页面源代码」,搜索
<script> 或 <code><link</script>,看实际插入的 src/href 是什么 - 打开浏览器 Network 面板,刷新页面,过滤 JS/CSS,点开资源看 Status 和 Response Headers,确认服务器返回的是 200 还是 404
- 如果用了 CDN 或反向代理,还要检查响应头中
X-Content-Type-Options或缓存策略是否干扰了静态文件加载
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











