public目录是laravel唯一可被web直接访问的静态资源入口，css/js等必须放于此；引用须用asset()或@vite/mix()，避免硬编码路径，并注意构建工具差异与加载顺序。
public 目录是唯一能被 Web 直接访问的静态资源入口
Laravel 的 CSS、JS、图片等静态文件，必须放在 public 目录下，否则 Nginx/Apache 根本不会转发请求，浏览器直接 404。别试图把 CSS 放进 resources/css 然后用 link 标签硬引——那个目录只供编译用，不对外暴露。
-
resources/css/app.css是源码，要通过npm run build或npm run dev编译到public/build/app.css（Vite）或public/css/app.css（Mix） - 如果你只是放个简单 CSS，直接丢进
public/css/style.css，然后在 Blade 中引用即可 - 别改 Web 服务器根目录去绕过这个规则，会破坏 Laravel 安全边界和升级兼容性
Blade 模板里用 asset() 生成正确 URL
直接写 <link href="/css/app.css" rel="stylesheet"> 看似能用，但一旦项目部署在子目录（比如 <a href="https://www.php.cn/link/1823d84d3a1658907dac3f1c08d9b4f0">https://www.php.cn/link/1823d84d3a1658907dac3f1c08d9b4f0</a>），路径就断了。asset() 会自动补上前缀，且支持 HTTPS 自适应。
- 始终用
<link href="%7B%7B%20asset('css/app.css')%20%7D%7D" rel="stylesheet"> -
asset()只处理public下的相对路径，不校验文件是否存在，拼错路径只会静默 404 - 开发时开启
APP_DEBUG=true，配合浏览器开发者工具的 Network 面板，一眼看出 404 的 CSS 请求到底卡在哪一层（是路径错？还是没编译？还是权限问题？）
Vite 和 Mix 的引用方式完全不同，不能混用
Laravel 9+ 默认用 Vite，老项目可能还在用 Mix；两者构建产物结构、哈希命名、入口配置都不同，引用方式也得跟着变。
- Vite 项目：CSS 经常被打包进
public/build/，带哈希名，必须配合@vite指令，例如@vite(['resources/css/app.css', 'resources/js/app.js'])—— 这行会自动注入带版本号的 CSS/JS，并启用 HMR - Mix 项目：用
mix()替代asset()，例如<link href="%7B%7B%20mix('css/app.css')%20%7D%7D" rel="stylesheet">，它会读mix-manifest.json查找哈希后缀 - 切换构建工具后，务必删掉旧的
public/mix-manifest.json或public/build/，否则缓存残留会导致引用错文件
CSS 文件加载顺序和作用域容易被忽略
Laravel 默认的 app.blade.php 把 @yield('styles') 放在 底部，而第三方库的 CSS（比如 Bootstrap）如果用 @vite 引入，会插在最前面——结果自定义样式被覆盖，调试半天找不到原因。
立即学习“前端免费学习笔记（深入）”；
- 把关键 CSS（如重置、变量定义、基础组件）放在
@vite之前，用asset()手动引入 - Blade 中的
@stack('styles')和@push('styles')比@yield更灵活，适合按需注入页面级样式 - 生产环境开启
VITE_BUILD_MINIFY=terser时，CSS 里的注释和空格会被删，别依赖注释做调试标记
Vite 的 @vite 指令默认不处理纯 CSS 文件（比如 resources/css/custom.css），必须显式加进数组里，漏掉就等于没引——这种“静默失效”最难排查。
