@vite只加载参数数组中明确列出的路径，不会自动解析js中的css导入；必须显式添加css路径如@vite(['resources/js/app.js', 'resources/css/app.css'])，并确保manifest.json包含对应映射、build.outdir未被手动修改、路径以resources/开头且未嵌套在blade指令块内。
@vite 传入的路径没包含 CSS 文件
Blade 模板里 @vite 指令只加载它参数数组里明确列出的入口文件，不会自动扫描或推断关联的 CSS。如果你只写了 @vite(['resources/js/app.js'])，而 app.js 里虽然 import './app.css'，Vite 开发服务器能热更新，但生产构建时，app.css 不会出现在 manifest.json 中——因为 Laravel 的 @vite 逻辑只认数组里写的路径，不递归解析依赖。
常见错误现象：开发时样式正常，build 后页面无 CSS；查看 public/build/manifest.json，发现只有 JS 条目，没有 CSS 对应项。
- 必须显式把 CSS 入口加进数组：
@vite(['resources/js/app.js', 'resources/css/app.css']) - 确保
resources/css/app.css是真实存在的文件，且内容合法（比如含@tailwind base;等有效规则） - 如果用的是单文件组件（如 Vue），CSS 写在
<style></style>块里，那它会被自动打包进 JS bundle，无需单独列 CSS 路径；但纯 CSS 文件必须手动声明
build.outDir 被改过，导致 manifest.json 找不到
Laravel 的 @vite 在生产环境硬编码读取 public/build/manifest.json。如果你在 vite.config.js 里改了 build.outDir（比如设成 'public/assets'），Vite 确实会把文件输出到那里，但 @vite 还是去 public/build/ 找，结果 manifest 缺失，CSS（和 JS）路径全部 fallback 失败。
常见错误现象：运行 npm run build 后 public/assets/manifest.json 存在，但页面仍 404 加载 CSS；控制台看到请求的是 /build/assets/app.xxxx.css，而不是 /assets/...。
- 删掉
vite.config.js中手动写的build.outDir字段，让laravel()插件自己控制输出位置 - 如果真要改输出目录（如用
public/assets），必须同步修改config/vite.php中的'build_directory' => 'assets'，否则@vite不会知道新位置 - 确认
public/build/manifest.json文件存在、非空、JSON 格式正确，且里面至少有一条 CSS 的映射，例如"resources/css/app.css": "assets/app.xxxx.css"
CSS 文件被 import 但路径写错或未启用 PostCSS
Vite 默认不处理 @tailwind、@layer 这类 Tailwind 指令，也不自动加 vendor 前缀。如果 app.css 里写了 Tailwind 的 @tailwind base; 却没配 PostCSS，构建后 CSS 内容为空或报错，最终生成的 CSS 文件体积极小甚至为 0 字节。
常见错误现象：build 后 public/build/assets/app.xxxx.css 文件存在但大小为 0 或仅含注释；浏览器控制台显示 CSS 加载成功但无样式生效。
- 检查项目是否安装了
postcss和autoprefixer：npm install -D postcss autoprefixer - 确认根目录有
postcss.config.js，内容至少包含：module.exports = { plugins: { autoprefixer: {} } }; - Tailwind 用户还必须确保
tailwind.config.js的content字段覆盖了 Blade 模板路径，否则 PurgeCSS 可能误删所有类名
blade 模板中 @vite 放错了位置
@vite 必须在 Blade 编译阶段就被解析，不能包裹在条件、section 或其他指令块里。一旦嵌套，Laravel 就无法提前提取资源路径，导致整个指令被忽略或报错。
常见错误现象：页面完全没加载任何 Vite 注入的脚本或 link 标签；PHP 报错 Array to string conversion（说明参数不是数组）或直接空白渲染。
-
@vite必须放在或最外层，不要在@if、@section、@push里面 - 参数必须是数组，哪怕只有一个文件：
@vite(['resources/css/app.css'])✅，@vite('resources/css/app.css')❌ - 路径必须以
resources/开头，不能写./resources/css/app.css或css/app.css（后者会被当成 public 下路径，Vite 插件找不到入口）
manifest.json 是否包含你的 CSS 路径，比调样式更优先。前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
