根本原因是 mix.version() 未正确启用或未在生产环境执行，导致文件名无哈希、URL 不变、浏览器复用旧缓存；需确认 webpack.mix.js 含 .version()、运行 npm run production、Blade 中使用 mix() 函数且路径匹配 manifest 键名。
你在 Laravel 项目中修改了 CSS 文件，但浏览器仍加载旧样式，说明资源路径未触发缓存失效——根本原因是 mix.version() 未正确启用或未在生产环境执行，导致文件名无哈希、URL 不变、浏览器复用旧缓存。
确认 mix.version() 是否已启用
打开项目根目录下的 webpack.mix.js 文件，检查是否在链式调用末尾添加了 .version()。例如：
mix.js('resources/js/app.js', 'public/js')<br> .sass('resources/sass/app.scss', 'public/css')<br> .version();
若缺失该行，则哈希文件名和 mix-manifest.json 都不会生成，mix() 函数将退化为返回原始路径，且不报错。
立即学习“前端免费学习笔记（深入）”；
注意：Laravel 9+ 默认配置可能已含 .version()，但若你手动删过或在开发环境误删，需手动补回。
必须在 production 模式下运行才能生成哈希文件
执行 npm run production（不是 npm run dev 或 npm run build）。
这一步会触发三件事：编译资源 → 重命名输出文件（如 css/app.css?id=8a3f2d）→ 生成 public/mix-manifest.json 映射表。
如果只跑 npm run dev，.version() 不生效，manifest 文件为空或不存在，mix() 在 Blade 中将返回空字符串或 404。
CI/CD 部署时，务必确保构建阶段包含 npm ci && npm run production，而非仅拷贝源码。
Blade 中必须用 mix() 引入资源
在模板中替换所有硬编码路径：
❌ 错误写法：<link rel="stylesheet" href="/css/app.css">
✅ 正确写法：<link rel="stylesheet" href="{{ mix('css/app.css') }}">
mix() 函数不读取文件内容，只查 mix-manifest.json 中的键值映射。若 manifest 里没有 /css/app.css 这个 key，就返回空。
确保传给 mix() 的路径与 webpack.mix.js 中输出路径一致：比如你输出到 public/css/app.css，那么 mix() 中必须写 'css/app.css'，不能写 '/css/app.css' 或 'assets/css/app.css'。
排除 copy() 导致 version 失败的隐藏陷阱
如果你在 webpack.mix.js 中使用了 mix.copy()，尤其源路径含英文点号（如 'resources/assets/js/lib/editor.md'），mix.version() 会直接报 EISDIR 错误并中断构建。
方法一：将带点的目录名改写为连字符，例如 editor-md 替代 editor.md；
方法二：把 copy 操作移到 .version() 之后，并用 .then() 包裹（实测有效）：
mix.sass('resources/sass/app.scss', 'public/css')<br> .version()<br> .then(() => {<br> mix.copy('resources/assets/js/lib/editor-md', 'public/lib/editor-md');<br> });
该问题源于 Laravel Mix 内部对含点路径的 fs.readSync 调用异常，非配置错误，但极易卡住整个版本化流程。
验证哈希是否真正生效
第一步：检查 public/mix-manifest.json 是否存在且内容非空，例如：{"\/css/app.css": "\/css/app.css?id=8a3f2d1e"}；
第二步：查看 public/css/ 目录下是否存在带 ?id= 或 .hash. 后缀的文件；
第三步：在浏览器中打开页面，右键“查看页面源代码”，搜索 mix('css/app.css') 输出的 URL，确认其包含哈希片段；
第四步：清空浏览器缓存后刷新，观察 Network 面板中 CSS 请求状态码是否为 200 且响应头含 Cache-Control: public, max-age=31536000。
