结论：resources/css/app.css是源码，必须经npm run build（Vite）或npm run prod（Mix）编译至public/下，再通过@vite或mix()引入；直接asset('css/app.css')必404，因Laravel不自动编译或复制源码文件。
直接说结论：你写的 resources/css/app.css 不是浏览器能加载的文件，必须用 npm run build（Vite）或 npm run prod（Mix）编译到 public/ 下，再通过 @vite 或 mix() 引入——硬写 asset('css/app.css') 一定 404。
为什么 public/css/app.css 不存在，但 asset() 还是报 404？
因为 resources/css/app.css 是源码，不是可部署文件。Laravel 不会自动复制或编译它。常见错误现象：
- 浏览器 Network 面板看到
GET /css/app.css 404，但你确实在public/css/里手动建了这个文件 → 可能是 Web 服务器权限没开，或路径大小写不一致（Linux 区分大小写） - 你改了
resources/css/app.css，刷新页面样式没变 → 没运行编译命令，或浏览器缓存了旧 CSS - 用了
@vite(['resources/css/app.css'])却提示 “entry not found” → Vite 配置里没把该路径加进build.rollupOptions.input
Vite 项目：CSS 必须走 @vite()，不能用 asset()
Vite 默认把 CSS 打包进 public/build/，带哈希名（如 assets/app.123abc.css），asset() 无法自动匹配哈希，所以必须用 @vite 指令：
- 在 Blade 中写
@vite(['resources/css/app.css', 'resources/js/app.js'])，它会自动注入正确路径 + 启用 HMR（开发时热更新） - 只引入 CSS 不想引 JS？可以单独写
@vite(['resources/css/app.css'])，但注意：Vite 要求入口存在且被 import 过，否则构建失败 - 如果要用 CDN 或独立 CSS（比如第三方 UI 库），仍可用
asset()，例如{{ asset('css/layui.css') }}—— 前提是这个文件已手动放进了public/css/
Mix 项目：mix() 替代 asset()，且依赖 mix-manifest.json
Mix 把编译结果写进 public/mix-manifest.json，mix() 函数靠它查哈希路径。容易踩的坑：
立即学习“前端免费学习笔记（深入）”；
- 运行过
npm run dev但没生成mix-manifest.json→ 检查webpack.mix.js是否调用了mix.css()或mix.sass() - 升级 Mix 后样式失效 → 删掉旧的
public/mix-manifest.json和public/css/下所有文件，再重跑npm run prod -
mix('css/app.css')返回/css/app.css?id=xxx，但实际文件是public/css/app.css→ 说明没启用版本控制，确认webpack.mix.js里有.version()
自定义 CSS 文件怎么处理才不混乱？
别把所有 CSS 都塞进 app.css。按场景拆分更可控：
- 全局样式：继续走
resources/css/app.css→@vite或mix() - 页面专属样式（如后台用户页）：新建
resources/css/users/index.css，在对应 Blade 里用@section('styles')+@vite(['resources/css/users/index.css'])（需确保父模板@yield('styles')在内） - 第三方库（如 Chart.js 样式）：下载后放
public/vendor/chart/css/，用{{ asset('vendor/chart/css/chart.css') }}—— 它不参与构建，就别强塞进 Vite/Mix
最常被忽略的一点：CSS 加载顺序决定覆盖逻辑。@vite 插入的样式默认在 最前面，如果你的自定义 CSS 在后面，但没加 !important，很可能被 Bootstrap 或 Tailwind 覆盖掉。调整顺序，比调选择器优先级更省事。
